@cursor/bdk 0.2.11 → 0.2.13

package/dist/internal/hosted-catch.js

@@ -59,7 +59,7 @@ export async function replayCatchRequest(input) {
         });
     }
     const matched = router.match(envelope.method, envelope.path);
-    const route = input.routes.find(candidate => candidate.method === matched?.route.method && candidate.path === matched.route.pattern);
+    const route = input.routes.find((candidate) => candidate.method === matched?.route.method && candidate.path === matched.route.pattern);
     if (matched === undefined || route === undefined) {
         // The control plane routes from the same pinned manifest this VM was
         // frozen from; a miss here is drift, not a caller error.

package/dist/internal/hosted-delivery-protocol.d.ts

@@ -60,6 +60,23 @@ export declare const HOSTED_REMINDER_CHANNEL_KIND = "agent-sdk:reminder";
  * Payload is {@link HostedReminderFirePayload}.
  */
 export declare const HOSTED_REMINDER_EVENT_TYPE = "agent-sdk.reminder/fire";
+/**
+ * Reserved hosted-admission `channelKind` for authored schedule fires.
+ * Bypasses authored channel admission and invokes ScheduleRunner.dispatch.
+ * Backend builds envelopes with this constant + {@link HOSTED_SCHEDULE_EVENT_TYPE}.
+ */
+export declare const HOSTED_SCHEDULE_CHANNEL_KIND = "agent-sdk:schedule";
+/**
+ * Reserved hosted-admission `eventType` for authored schedule fires.
+ * Payload is {@link HostedScheduleFirePayload}.
+ */
+export declare const HOSTED_SCHEDULE_EVENT_TYPE = "agent-sdk.schedule/fire";
+/** One fire of an authored `agent/schedules/*` declaration. */
+export type HostedScheduleFirePayload = {
+    protocolVersion: 1;
+    scheduleId: string;
+    scheduledAtMs: number;
+};
 /** Compact reminder-fire payload on the reserved hosted-admission path. */
 export type HostedReminderFirePayload = {
     reminderId: string;
@@ -233,6 +250,13 @@ export declare function parseHostedExecutionOutcome(value: unknown): HostedExecu
  * path (not an authored channel event).
  */
 export declare function isHostedReminderAdmission(delivery: HostedAdmissionInput): boolean;
+/**
+ * True when the admission envelope is the reserved internal schedule fire
+ * path (not an authored channel event).
+ */
+export declare function isHostedScheduleAdmission(delivery: HostedAdmissionInput): boolean;
+/** Parse a reserved schedule admission payload. Rejects unknown keys. */
+export declare function parseHostedScheduleFirePayload(value: unknown): HostedScheduleFirePayload | undefined;
 /**
  * Parse `{ reminderId, fireCount }` from a reserved reminder admission
  * payload. Rejects unknown keys and non-integer fireCount.

package/dist/internal/hosted-delivery-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"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"}

package/dist/internal/hosted-delivery-protocol.js

@@ -118,6 +118,17 @@ export const HOSTED_REMINDER_CHANNEL_KIND = "agent-sdk:reminder";
  * Payload is {@link HostedReminderFirePayload}.
  */
 export const HOSTED_REMINDER_EVENT_TYPE = "agent-sdk.reminder/fire";
+/**
+ * Reserved hosted-admission `channelKind` for authored schedule fires.
+ * Bypasses authored channel admission and invokes ScheduleRunner.dispatch.
+ * Backend builds envelopes with this constant + {@link HOSTED_SCHEDULE_EVENT_TYPE}.
+ */
+export const HOSTED_SCHEDULE_CHANNEL_KIND = "agent-sdk:schedule";
+/**
+ * Reserved hosted-admission `eventType` for authored schedule fires.
+ * Payload is {@link HostedScheduleFirePayload}.
+ */
+export const HOSTED_SCHEDULE_EVENT_TYPE = "agent-sdk.schedule/fire";
 /**
  * Handler 4xx reasons an admission skip can carry. Benign skips (nothing to
  * do) omit `rejection`. Engine HTTP failures use the hosted failure codes
@@ -183,7 +194,7 @@ export function parseHostedAdmissionHandlerRejection(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !HOSTED_ADMISSION_REJECTION_KEYS.has(key))) {
+    if (Object.keys(body).some((key) => !HOSTED_ADMISSION_REJECTION_KEYS.has(key))) {
         return undefined;
     }
     if (typeof body.reason !== "string" ||
@@ -244,18 +255,18 @@ function parseManagedAutomation(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !MANAGED_AUTOMATION_KEYS.has(key)) ||
+    if (Object.keys(body).some((key) => !MANAGED_AUTOMATION_KEYS.has(key)) ||
         !boundedString(body.automationUuid, 128) ||
         !Array.isArray(body.mcpServerNames) ||
         body.mcpServerNames.length > MANAGED_AUTOMATION_MAX_SERVERS ||
-        !body.mcpServerNames.every(name => boundedString(name, 256))) {
+        !body.mcpServerNames.every((name) => boundedString(name, 256))) {
         return undefined;
     }
     if (body.slackChannels !== undefined) {
         if (!Array.isArray(body.slackChannels) ||
             body.slackChannels.length === 0 ||
             body.slackChannels.length > MANAGED_AUTOMATION_MAX_SLACK_CHANNELS ||
-            !body.slackChannels.every(channel => boundedString(channel, 64))) {
+            !body.slackChannels.every((channel) => boundedString(channel, 64))) {
             return undefined;
         }
     }
@@ -281,7 +292,7 @@ function parsePlatformHandoff(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !HOSTED_PLATFORM_HANDOFF_KEYS.has(key)) || body.v !== 1) {
+    if (Object.keys(body).some((key) => !HOSTED_PLATFORM_HANDOFF_KEYS.has(key)) || body.v !== 1) {
         return undefined;
     }
     const placeholder = body.slackPlaceholder;
@@ -289,7 +300,7 @@ function parsePlatformHandoff(value) {
         return undefined;
     }
     const slot = placeholder;
-    if (Object.keys(slot).some(key => !HOSTED_SLACK_PLACEHOLDER_HANDOFF_KEYS.has(key)) ||
+    if (Object.keys(slot).some((key) => !HOSTED_SLACK_PLACEHOLDER_HANDOFF_KEYS.has(key)) ||
         !boundedString(slot.messageTs, 64) ||
         !boundedString(slot.channelId, 64) ||
         !boundedString(slot.threadTs, 64) ||
@@ -314,13 +325,13 @@ export function parseHostedAdmission(value) {
     }
     const body = value;
     if (body.mode === "status") {
-        return Object.keys(body).every(key => key === "v" || key === "mode" || key === "deliveryId") &&
+        return Object.keys(body).every((key) => key === "v" || key === "mode" || key === "deliveryId") &&
             body.v === HOSTED_DELIVERY_PROTOCOL_VERSION &&
             boundedString(body.deliveryId, 256)
             ? body
             : undefined;
     }
-    if (Object.keys(body).some(key => !DELIVERY_KEYS.has(key)) ||
+    if (Object.keys(body).some((key) => !DELIVERY_KEYS.has(key)) ||
         !Object.hasOwn(body, "payload") ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
         body.mode !== "start" ||
@@ -342,7 +353,7 @@ export function parseHostedExecution(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !EXECUTION_KEYS.has(key)) ||
+    if (Object.keys(body).some((key) => !EXECUTION_KEYS.has(key)) ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
         !boundedString(body.admissionToken, 128) ||
         typeof body.sessionPublicId !== "string" ||
@@ -362,7 +373,7 @@ function parseConsumedDeliveryIds(value) {
     if (value.length > HOSTED_MAX_CONSUMED_DELIVERY_IDS) {
         return undefined;
     }
-    if (!value.every(id => boundedString(id, 256))) {
+    if (!value.every((id) => boundedString(id, 256))) {
         return undefined;
     }
     return value;
@@ -372,7 +383,7 @@ export function parseHostedExecutionOutcome(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !HOSTED_EXECUTION_OUTCOME_KEYS.has(key)) ||
+    if (Object.keys(body).some((key) => !HOSTED_EXECUTION_OUTCOME_KEYS.has(key)) ||
         body.ok !== true ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION) {
         return undefined;
@@ -408,6 +419,39 @@ export function isHostedReminderAdmission(delivery) {
     return (delivery.channelKind === HOSTED_REMINDER_CHANNEL_KIND &&
         delivery.eventType === HOSTED_REMINDER_EVENT_TYPE);
 }
+/**
+ * True when the admission envelope is the reserved internal schedule fire
+ * path (not an authored channel event).
+ */
+export function isHostedScheduleAdmission(delivery) {
+    return (delivery.channelKind === HOSTED_SCHEDULE_CHANNEL_KIND &&
+        delivery.eventType === HOSTED_SCHEDULE_EVENT_TYPE);
+}
+const HOSTED_SCHEDULE_FIRE_PAYLOAD_KEYS = new Set([
+    "protocolVersion",
+    "scheduleId",
+    "scheduledAtMs",
+]);
+/** Parse a reserved schedule admission payload. Rejects unknown keys. */
+export function parseHostedScheduleFirePayload(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const body = value;
+    if (Object.keys(body).some((key) => !HOSTED_SCHEDULE_FIRE_PAYLOAD_KEYS.has(key)) ||
+        body.protocolVersion !== 1 ||
+        !boundedString(body.scheduleId, 128) ||
+        typeof body.scheduledAtMs !== "number" ||
+        !Number.isSafeInteger(body.scheduledAtMs) ||
+        body.scheduledAtMs < 0) {
+        return undefined;
+    }
+    return {
+        protocolVersion: 1,
+        scheduleId: body.scheduleId,
+        scheduledAtMs: body.scheduledAtMs,
+    };
+}
 /**
  * Parse `{ reminderId, fireCount }` from a reserved reminder admission
  * payload. Rejects unknown keys and non-integer fireCount.
@@ -476,7 +520,7 @@ function isJsonSafeValue(value, depth) {
         return false;
     }
     if (Array.isArray(value)) {
-        return value.every(entry => isJsonSafeValue(entry, depth + 1));
+        return value.every((entry) => isJsonSafeValue(entry, depth + 1));
     }
     const proto = Object.getPrototypeOf(value);
     if (proto !== Object.prototype && proto !== null) {
@@ -523,7 +567,7 @@ export function parseHostedReminderFireDescriptorPayload(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS.has(key))) {
+    if (Object.keys(body).some((key) => !HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS.has(key))) {
         return undefined;
     }
     if (body.protocolVersion !== 1 ||
@@ -631,7 +675,7 @@ export function parseHostedAdmissionOutcome(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some(key => !HOSTED_ADMISSION_OUTCOME_KEYS.has(key)) ||
+    if (Object.keys(body).some((key) => !HOSTED_ADMISSION_OUTCOME_KEYS.has(key)) ||
         body.ok !== true ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
         (body.outcome !== "skip" &&

package/dist/internal/hosted-delivery.d.ts

@@ -65,6 +65,12 @@ export declare function registerHostedDeliveryRoute(input: {
         outcome: "fired" | "noop";
         reason?: string;
     }>;
+    /**
+     * Reserved schedule admission: run the named authored schedule and resolve
+     * only after every turn and `waitUntil` it started has settled. Throws
+     * {@link UnknownScheduleError} for a name this release does not declare.
+     */
+    fireSchedule?(scheduleId: string): Promise<unknown>;
     /**
      * Await the session's durable mirror (dispatch chain + storage queue)
      * before the execution reply: the control plane may park the pod the

package/dist/internal/hosted-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}

package/dist/internal/hosted-delivery.js

@@ -1,4 +1,5 @@
 import { randomBytes } from "node:crypto";
+import { metrics } from "@opentelemetry/api";
 import { packageVersion } from "./distribution.js";
 import { dispatchOutcome } from "./channel-dispatch.js";
 import { consumeHostedBoundSecrets, } from "./cursor/hosted-bound-secrets.js";
@@ -8,7 +9,7 @@ import { classifyExpectedDeliveryFailure } from "./expected-delivery-failure.js"
 import { formatGuestNetworkServerTiming, GUEST_CONNECT_STALLED, GUEST_NETWORK_UNAVAILABLE, GuestNetworkUnavailableError, waitForGuestNetworkReady, } from "./guest-network.js";
 import { getHostedAdmissionAdapter, } from "./hosted-admission-adapter.js";
 import { HostedAdmissionLocalSendError, runDuringHostedAdmission, } from "./hosted-admission-context.js";
-import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, HOSTED_MAX_CONSUMED_DELIVERY_IDS, hostedFailureClassification, hostedGuestErrorResponse, isHostedReminderAdmission, parseHostedAdmissionHandlerRejection, parseHostedAdmission, parseHostedExecution, parseHostedReminderFireDescriptorPayload, parseHostedReminderFirePayload, } from "./hosted-delivery-protocol.js";
+import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, HOSTED_MAX_CONSUMED_DELIVERY_IDS, hostedFailureClassification, hostedGuestErrorResponse, isHostedReminderAdmission, isHostedScheduleAdmission, parseHostedAdmissionHandlerRejection, parseHostedAdmission, parseHostedExecution, parseHostedReminderFireDescriptorPayload, parseHostedReminderFirePayload, parseHostedScheduleFirePayload, } from "./hosted-delivery-protocol.js";
 import { abortReasonFromTurnStatus, HOSTED_EXECUTION_DIAG_RUNNING_STATUS, hostedExecutionDiagId, } from "./hosted-execution-diag.js";
 import { flushHostedExecutionRecord, refreshStartLogWhile, } from "./hosted-execution-flush.js";
 import { finalizeHostedExecutionLatency, formatHostedExecutionLatencyServerTiming, hostedExecutionNow, runWithHostedExecutionLatency, } from "./hosted-execution-latency.js";
@@ -17,6 +18,7 @@ import { readJsonObject } from "./http-channel.js";
 import { endActiveHttpSpan } from "./otel/http.js";
 import { ReminderValidationError, UnknownReminderError } from "./reminder-runner.js";
 import { mapThrownRequestError, statusForThrownRequestError } from "./request-error-status.js";
+import { UnknownScheduleError } from "./schedule-runner.js";
 import { HostedEnqueueNotActiveError } from "./session-engine.js";
 async function responseToReply(response) {
     const value = (await response.json());
@@ -215,6 +217,39 @@ async function dispatchHostedReminderAdmission(input, delivery) {
         throw error;
     }
 }
+/**
+ * Reserved schedule admission: run the authored schedule by name and wait
+ * for everything it started before replying, because the control plane may
+ * park the VM as soon as this reply lands. Returns `task` (work ran) and
+ * never opens the send-capture / model-session path.
+ */
+async function dispatchHostedScheduleAdmission(input, delivery) {
+    if (input.fireSchedule === undefined) {
+        return transientHostedError(503, "schedule_dispatch_unavailable", "This guest has no schedule runner wired for hosted admission.");
+    }
+    const payload = parseHostedScheduleFirePayload(delivery.payload);
+    if (payload === undefined) {
+        return terminalHostedError(400, "invalid_schedule_payload", "Expected { protocolVersion: 1, scheduleId, scheduledAtMs }.");
+    }
+    try {
+        await input.fireSchedule(payload.scheduleId);
+    }
+    catch (error) {
+        if (error instanceof UnknownScheduleError) {
+            return terminalHostedError(404, "unknown_schedule", boundedMessage(error.message));
+        }
+        const mapped = mappedAdmissionFailure(error);
+        if (mapped !== undefined) {
+            return mapped.response;
+        }
+        return terminalHostedError(500, "agent_admission_threw", boundedMessage(error instanceof Error ? error.message : String(error)));
+    }
+    return Response.json({
+        ok: true,
+        v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+        outcome: "task",
+    });
+}
 async function runAdmission(input, adapter) {
     const background = [];
     let captured;
@@ -227,7 +262,7 @@ async function runAdmission(input, adapter) {
             captured = { message, options };
             return createDeferredChannelSession();
         },
-        waitUntil: promise => {
+        waitUntil: (promise) => {
             background.push(promise);
         },
     };
@@ -441,6 +476,9 @@ export function registerHostedDeliveryRoute(input) {
             if (isHostedReminderAdmission(delivery)) {
                 return await responseToReply(finish(await dispatchHostedReminderAdmission(input, delivery)));
             }
+            if (isHostedScheduleAdmission(delivery)) {
+                return await responseToReply(finish(await dispatchHostedScheduleAdmission(input, delivery)));
+            }
             if (definition === undefined) {
                 return await responseToReply(finish(terminalHostedError(404, "channel_not_found", `No channel named "${delivery.channelId}" is mounted.`)));
             }
@@ -473,7 +511,7 @@ export function registerHostedDeliveryRoute(input) {
     });
     // Hosted callers reach this only through Anyrun's signed pod-port URL.
     // The marker is a second, route-specific fence distinct from channel auth.
-    const auth = request => {
+    const auth = (request) => {
         if (request.headers.get(HOSTED_DELIVERY_HEADER) !== "1") {
             return null;
         }
@@ -535,15 +573,15 @@ export function registerHostedDeliveryRoute(input) {
             }
             console.info(`[bdk] hosted admission received deliveryId=${delivery.deliveryId} channelId=${delivery.channelId} channelKind=${delivery.channelKind} eventType=${delivery.eventType} sessionMode=${delivery.sessionMode} managedAutomation=${delivery.managedAutomation === undefined ? "<absent>" : `automationUuid=${delivery.managedAutomation.automationUuid} mcpServerNames=${String(delivery.managedAutomation.mcpServerNames.length)} slackChannels=${delivery.managedAutomation.slackChannels === undefined ? "<absent>" : JSON.stringify(delivery.managedAutomation.slackChannels)}`}`);
             recordHostedManagedAutomation(delivery);
-            const reminder = isHostedReminderAdmission(delivery);
-            const definition = reminder
+            const reserved = isHostedReminderAdmission(delivery) || isHostedScheduleAdmission(delivery);
+            const definition = reserved
                 ? undefined
-                : input.channels.find(candidate => candidate.id === delivery.channelId)?.definition;
-            if (!reminder && definition === undefined) {
+                : input.channels.find((candidate) => candidate.id === delivery.channelId)?.definition;
+            if (!reserved && definition === undefined) {
                 return finish(terminalHostedError(404, "channel_not_found", `No channel named "${delivery.channelId}" is mounted.`));
             }
             let operation;
-            const execution = runAdmissionOperation(delivery, definition).then(reply => {
+            const execution = runAdmissionOperation(delivery, definition).then((reply) => {
                 operation.settledReply = reply;
                 operation.expiresAt = Date.now() + pendingTtlMs;
                 return reply;
@@ -555,7 +593,7 @@ export function registerHostedDeliveryRoute(input) {
             admissions.set(delivery.deliveryId, operation);
             const quickReply = await Promise.race([
                 execution,
-                new Promise(resolve => setImmediate(() => resolve(undefined))),
+                new Promise((resolve) => setImmediate(() => resolve(undefined))),
             ]);
             if (quickReply !== undefined) {
                 return responseFromReply(quickReply);
@@ -824,11 +862,11 @@ export function registerHostedDeliveryRoute(input) {
                         }
                     }
                 });
-            }).then(reply => {
+            }).then((reply) => {
                 admitted.settledReply = reply;
                 admitted.expiresAt = Date.now() + pendingTtlMs;
                 return reply;
-            }, error => {
+            }, (error) => {
                 admitted.settledReply = {
                     status: 503,
                     body: {
@@ -845,7 +883,7 @@ export function registerHostedDeliveryRoute(input) {
             if (execution.mode === "start") {
                 const quickReply = await Promise.race([
                     admitted.execution,
-                    new Promise(resolve => setImmediate(() => resolve(undefined))),
+                    new Promise((resolve) => setImmediate(() => resolve(undefined))),
                 ]);
                 if (quickReply !== undefined) {
                     return responseFromReply(quickReply);
@@ -874,7 +912,7 @@ async function enqueueIntoActiveOwner(input) {
         return { outcome: "not_active" };
     }
     let resolveResult;
-    const resultPromise = new Promise(resolve => {
+    const resultPromise = new Promise((resolve) => {
         resolveResult = resolve;
     });
     owner.enqueueResults.set(input.deliveryId, resultPromise);
@@ -937,12 +975,22 @@ function evictHostedSdkSessions(evict, ...ids) {
 }
 const TRANSIENT_TURN_ERROR_CODES = new Set([
     "ABORT_ERR",
+    "connection_stalled",
     "UND_ERR_BODY_TIMEOUT",
     "UND_ERR_HEADERS_TIMEOUT",
     "canceled",
     "unavailable",
     "unknown",
 ]);
+let stallRetriedCounter;
+function recordStallRetried() {
+    if (stallRetriedCounter === undefined) {
+        stallRetriedCounter = metrics.getMeter("agent_sdk").createCounter("hosted.turn.stall_retried", {
+            description: "Hosted turns classified for transient retry after connection_stalled",
+        });
+    }
+    stallRetriedCounter.add(1, { failure_kind: "connection_stalled" });
+}
 function hostedFailureForUnfinishedTurn(outcome) {
     if (outcome.errorCode === "agent_dependency_failed") {
         return {
@@ -965,6 +1013,9 @@ function hostedFailureForUnfinishedTurn(outcome) {
     if (outcome.status === "error" &&
         outcome.errorCode !== undefined &&
         TRANSIENT_TURN_ERROR_CODES.has(outcome.errorCode)) {
+        if (outcome.errorCode === "connection_stalled") {
+            recordStallRetried();
+        }
         return {
             error: GUEST_CONNECT_STALLED,
             retry: HOSTED_GUEST_RETRY_TRANSIENT,

package/dist/internal/hosted-eval-cases.js

@@ -19,7 +19,7 @@ export async function hostedEvalCatalog(projectRoot) {
     const { evals, config } = await discoverEvals(projectRoot);
     return {
         protocol: 1,
-        cases: evals.map(e => ({
+        cases: evals.map((e) => ({
             id: e.id,
             fileId: e.fileId,
             description: e.definition.description,
@@ -55,7 +55,7 @@ async function runHostedEvalCase(input) {
     const deadline = new AbortController();
     const cancel = new AbortController();
     const result = await Promise.race([
-        runCase({ ...input, signal: cancel.signal }).catch(error => failedResult(input.evalCase, describeError(error), startedAt)),
+        runCase({ ...input, signal: cancel.signal }).catch((error) => failedResult(input.evalCase, describeError(error), startedAt)),
         sleep(deadlineMs, undefined, { signal: deadline.signal }).then(async () => {
             // The losing case body keeps running; it must not start turns after this verdict.
             cancel.abort();
@@ -70,7 +70,7 @@ async function runHostedEvalCase(input) {
 async function runCase(input) {
     const startedAt = Date.now();
     const { evals, config } = await discoverEvals(input.projectRoot);
-    const discovered = evals.find(e => e.id === input.evalCase.caseId);
+    const discovered = evals.find((e) => e.id === input.evalCase.caseId);
     if (discovered === undefined) {
         return failedResult(input.evalCase, `No eval case ${JSON.stringify(input.evalCase.caseId)} in this release`, startedAt);
     }
@@ -152,7 +152,7 @@ function resultEventData(ref, result) {
         inputs: result.inputs,
         finalText: result.finalText,
         tools: result.tools,
-        toolCalls: result.toolCalls?.map(call => ({
+        toolCalls: result.toolCalls?.map((call) => ({
             toolName: call.toolName,
             args: boundedIo(call.args),
             output: boundedIo(call.output),

package/dist/internal/hosted-execution-diag.js

@@ -65,8 +65,8 @@ export function hostedErrorStackSnippet(error) {
         if (stack !== undefined && stack.length > 0) {
             const lines = stack
                 .split("\n")
-                .map(line => line.trimEnd())
-                .filter(line => line.trim().length > 0)
+                .map((line) => line.trimEnd())
+                .filter((line) => line.trim().length > 0)
                 .slice(0, HOSTED_ERROR_STACK_LINE_COUNT);
             const text = lines.join("\n");
             return text.length > HOSTED_ERROR_SNIPPET_MAX_CHARS
@@ -129,7 +129,7 @@ export function parseHostedExecutionDiag(raw) {
         return undefined;
     }
     const body = parsed;
-    if (Object.keys(body).some(key => !DIAG_KEYS.has(key))) {
+    if (Object.keys(body).some((key) => !DIAG_KEYS.has(key))) {
         return undefined;
     }
     if (body.v !== HOSTED_EXECUTION_DIAG_VERSION ||

package/dist/internal/hosted-managed-automation.d.ts

@@ -10,9 +10,9 @@
  * it without pulling the hosted-delivery route — and its session-engine
  * dependency graph — into their bundles.
  *
- * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
- * excluded from the published `@cursor/bdk` npm package (see the `files`
- * whitelist); consumed by internal deployments via relative source imports.
+ * INTERNAL: first-party multi-tenant deployment plumbing. It ships because
+ * the published hosted-delivery runtime imports it; it is not an exported
+ * package subpath.
  */
 import type { HostedAdmissionManagedAutomation } from "./hosted-delivery-protocol.js";
 export declare function recordHostedManagedAutomation(delivery: {

package/dist/internal/hosted-managed-automation.js

@@ -10,9 +10,9 @@
  * it without pulling the hosted-delivery route — and its session-engine
  * dependency graph — into their bundles.
  *
- * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
- * excluded from the published `@cursor/bdk` npm package (see the `files`
- * whitelist); consumed by internal deployments via relative source imports.
+ * INTERNAL: first-party multi-tenant deployment plumbing. It ships because
+ * the published hosted-delivery runtime imports it; it is not an exported
+ * package subpath.
  */
 /**
  * Process-wide slot for the table. Hosted engines run the compiled CLI

package/dist/internal/hosting.js

@@ -71,7 +71,7 @@ export function isReservedSecretName(name) {
         return true;
     }
     const upper = name.toUpperCase();
-    return PLATFORM_HOSTED_STORAGE_SECRET_NAMES.some(managed => managed === upper);
+    return PLATFORM_HOSTED_STORAGE_SECRET_NAMES.some((managed) => managed === upper);
 }
 /**
  * Grammar and platform-managed-name errors in declared egress domains and

package/dist/internal/http-channel.js

@@ -181,7 +181,7 @@ export function buildHttpChannelRoutes(args) {
                     playgroundUrl: playgroundUrlForSession(request, base, sessionId),
                 });
             }
-            const ndjson = `${snapshot.map(e => JSON.stringify(e)).join("\n")}${snapshot.length > 0 ? "\n" : ""}`;
+            const ndjson = `${snapshot.map((e) => JSON.stringify(e)).join("\n")}${snapshot.length > 0 ? "\n" : ""}`;
             return new Response(ndjson, {
                 status: 200,
                 headers: {

package/dist/internal/http-control-plane-session.js

@@ -31,7 +31,7 @@ export function parseControlPlaneSessionPayload(payload) {
     if (!isRecord(payload)) {
         return { ok: false, error: "payload must be an object" };
     }
-    if (Object.keys(payload).some(key => !PAYLOAD_KEYS.has(key))) {
+    if (Object.keys(payload).some((key) => !PAYLOAD_KEYS.has(key))) {
         return { ok: false, error: "payload carries an unsupported field" };
     }
     const message = typeof payload.message === "string" ? payload.message.trim() : "";
@@ -58,7 +58,7 @@ export function parseControlPlaneEvalCasePayload(payload) {
     if (!isRecord(payload)) {
         return { ok: false, error: "payload must be an object" };
     }
-    if (Object.keys(payload).some(key => !EVAL_CASE_PAYLOAD_KEYS.has(key))) {
+    if (Object.keys(payload).some((key) => !EVAL_CASE_PAYLOAD_KEYS.has(key))) {
         return { ok: false, error: "payload carries an unsupported field" };
     }
     for (const key of ["runId", "caseId"]) {

package/dist/internal/init-interview.js

@@ -22,7 +22,7 @@ export function isTemplateMetaPath(rel) {
 }
 export function templateFileHasReplacements(spec, rel) {
     const file = posixRel(rel);
-    return spec.replace.some(rule => posixRel(rule.file) === file);
+    return spec.replace.some((rule) => posixRel(rule.file) === file);
 }
 export async function loadTemplateInitSpec(templateDir) {
     try {
@@ -85,7 +85,7 @@ export async function collectTemplateAnswers(input) {
     const vars = input.vars ?? {};
     const answers = {};
     const ask = input.ask ?? promptTemplateQuestion;
-    const out = input.out ?? (text => process.stdout.write(text));
+    const out = input.out ?? ((text) => process.stdout.write(text));
     for (const question of input.spec.questions) {
         if (question.id in vars || !input.interactive) {
             const raw = vars[question.id]?.trim() || question.default;
@@ -143,7 +143,7 @@ export async function promptTemplateQuestion(question, options = {}) {
         if (question.hint !== undefined) {
             output.write(`  ${question.hint}\n`);
         }
-        return await new Promise(resolve => {
+        return await new Promise((resolve) => {
             rl.question(`${question.prompt}${suffix} `, resolve);
         });
     }
@@ -182,7 +182,7 @@ function parseQuestionValue(question, raw) {
     }
     if (question.parse === "owner-repo-list") {
         try {
-            const scope = parseCursorGithubRepoScope(trimmed.split(",").map(repo => repo.trim()));
+            const scope = parseCursorGithubRepoScope(trimmed.split(",").map((repo) => repo.trim()));
             return { ok: true, value: scope.repos.join(", ") };
         }
         catch (error) {
@@ -196,10 +196,10 @@ function formatReplaceValue(rule, answers) {
     if (raw === undefined || raw === "") {
         return undefined;
     }
-    const parts = raw.split(",").map(part => part.trim());
+    const parts = raw.split(",").map((part) => part.trim());
     let value = raw;
     if (rule.as === "json-array") {
-        value = `[${parts.map(part => JSON.stringify(part)).join(", ")}]`;
+        value = `[${parts.map((part) => JSON.stringify(part)).join(", ")}]`;
     }
     else if (rule.as === "first") {
         const first = parts[0];
@@ -234,7 +234,7 @@ function parseQuestion(value, index) {
         question.default = value.default;
     }
     if (Array.isArray(value.choices)) {
-        question.choices = value.choices.map(choice => String(choice));
+        question.choices = value.choices.map((choice) => String(choice));
     }
     if (value.parse === "owner-repo-list") {
         question.parse = "owner-repo-list";