@cursor/bdk 0.2.5 → 0.2.7

package/dist/internal/reminder-runner.js

@@ -14,7 +14,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { randomBytes } from "node:crypto";
 import { channelContinuationIdentity, httpContinuationIdentity } from "./continuation-channel.js";
-import { continuationSource } from "./continuation-identity.js";
+import { continuationSource, isOneShotContinuationKey } from "./continuation-identity.js";
 import { NAME_PATTERN } from "./discovery/names.js";
 import { parseDuration } from "./duration.js";
 import { REMINDER_CP_PROTOCOL_VERSION, scheduleSpecFromCreateInput, toWireReschedule, } from "./reminder-control-plane-protocol.js";
@@ -181,7 +181,7 @@ export class ReminderRunner {
             return;
         }
         this.controlPlaneReadFailureLogged = true;
-        this.logger(`[agent-sdk] reminders: control-plane ${what} failed: ${error instanceof Error ? error.message : String(error)}`);
+        this.logger(`[bdk] reminders: control-plane ${what} failed: ${error instanceof Error ? error.message : String(error)}`);
     }
     /**
      * Load reminder documents from the control plane into memory. Does not
@@ -210,7 +210,7 @@ export class ReminderRunner {
                 // The CP owns status; a fire whose handler is missing reports `stop`
                 // from executeFire instead of the guest writing a disarm.
                 if (remote.length > 0) {
-                    this.logger(`[agent-sdk] reminders: hydrated ${remote.length} reminder(s) from control plane`);
+                    this.logger(`[bdk] reminders: hydrated ${remote.length} reminder(s) from control plane`);
                 }
                 return;
             }
@@ -233,7 +233,7 @@ export class ReminderRunner {
                 }
             }
             if (remote.length > 0 || disarmedOrphan > 0) {
-                this.logger(`[agent-sdk] reminders: hydrated ${remote.length} reminder(s) from control plane` +
+                this.logger(`[bdk] reminders: hydrated ${remote.length} reminder(s) from control plane` +
                     (disarmedOrphan > 0 ? `; disarmed ${disarmedOrphan} without live handlers` : ""));
             }
         });
@@ -272,7 +272,7 @@ export class ReminderRunner {
                 restored += 1;
             }
             if (restored > 0 || disarmedOrphan > 0) {
-                this.logger(`[agent-sdk] reminders: restored ${restored} armed reminder(s)` +
+                this.logger(`[bdk] reminders: restored ${restored} armed reminder(s)` +
                     (disarmedOrphan > 0 ? `; disarmed ${disarmedOrphan} without live handlers` : ""));
             }
         });
@@ -334,6 +334,32 @@ export class ReminderRunner {
             return [...this.records.values()];
         });
     }
+    /**
+     * A keyed list asks the control plane for that key. An unfiltered list
+     * still uses allRecords. Do not replace the in-memory map with the keyed page.
+     */
+    recordsForList(filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.usesControlPlaneProtocol &&
+                ((filter === null || filter === void 0 ? void 0 : filter.purpose) !== undefined || (filter === null || filter === void 0 ? void 0 : filter.continuationToken) !== undefined)) {
+                try {
+                    const remote = yield this.controlPlane.listReminders(Object.assign(Object.assign({}, (filter.purpose === undefined ? {} : { purpose: filter.purpose })), (filter.continuationToken === undefined
+                        ? {}
+                        : { continuationToken: filter.continuationToken })));
+                    this.controlPlaneReadFailureLogged = false;
+                    for (const record of remote) {
+                        this.records.set(record.id, record);
+                    }
+                    return remote;
+                }
+                catch (error) {
+                    this.logControlPlaneReadFailure("list", error);
+                    throw error;
+                }
+            }
+            return this.allRecords();
+        });
+    }
     stop() {
         this.started = false;
         for (const timer of this.timers.values()) {
@@ -385,12 +411,15 @@ export class ReminderRunner {
                 if (name === "") {
                     throw new ReminderValidationError("handler name is required");
                 }
-                if (!isValidReminderHandlerName(name)) {
+                // A mounted extension's handler registers as `<ns>__<name>`, a name no
+                // authored stem may take.
+                const registered = this.namedHandlers.has(name);
+                if (!registered && !isValidReminderHandlerName(name)) {
                     throw new ReminderValidationError(name.includes("__")
-                        ? `Invalid reminder handler name "${name}": may not contain "__"`
+                        ? `Invalid reminder handler name "${name}": may not contain "__" (reserved for mounted extensions' <ns>__<name> handlers)`
                         : `Invalid reminder handler name "${name}": must match ${NAME_PATTERN}`);
                 }
-                if (this.namedHandlers.get(name) === undefined) {
+                if (!registered) {
                     throw new ReminderValidationError(`Unknown reminder handler "${name}" (expected reminders/${name}.ts under the project root)`);
                 }
                 if (input.args !== undefined && !isJsonObject(input.args)) {
@@ -469,7 +498,7 @@ export class ReminderRunner {
     }
     list(filter) {
         return __awaiter(this, void 0, void 0, function* () {
-            const all = yield this.allRecords();
+            const all = yield this.recordsForList(filter);
             return all
                 .filter(r => {
                 if ((filter === null || filter === void 0 ? void 0 : filter.status) !== undefined) {
@@ -634,7 +663,7 @@ export class ReminderRunner {
                     }
                 }
                 catch (error) {
-                    this.logger(`[agent-sdk] reminder "${record.id}" until() failed: ${error instanceof Error ? error.message : String(error)}`);
+                    this.logger(`[bdk] reminder "${record.id}" until() failed: ${error instanceof Error ? error.message : String(error)}`);
                 }
             }
             if (yield this.isSessionBusy(record.channelId, record.continuationToken)) {
@@ -688,7 +717,7 @@ export class ReminderRunner {
      * beside the control plane's `timed_work.fire` count.
      */
     recordFireOutcome(record, fire) {
-        this.logger(`[agent-sdk] reminder fire_outcome kind=${fire.kind} reason=${fire.reason}` +
+        this.logger(`[bdk] reminder fire_outcome kind=${fire.kind} reason=${fire.reason}` +
             ` reminderId=${record.id} purpose=${record.purpose}` +
             ` channelId=${record.channelId} fireCount=${record.fireCount}` +
             (fire.turnStatus === undefined ? "" : ` turn=${fire.turnStatus}`) +
@@ -706,7 +735,7 @@ export class ReminderRunner {
             });
         }
         catch (error) {
-            this.logger(`[agent-sdk] reminder fire_outcome metric failed: ${error instanceof Error ? error.message : String(error)}`);
+            this.logger(`[bdk] reminder fire_outcome metric failed: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     recordFromDescriptor(descriptor) {
@@ -745,7 +774,7 @@ export class ReminderRunner {
         const delay = Math.min(MAX_TIMER_MS, Math.max(0, nextFireAtMs - Date.now()));
         const timer = setTimeout(() => {
             void this.fire(record.id).catch((error) => __awaiter(this, void 0, void 0, function* () {
-                this.logger(`[agent-sdk] reminder "${record.id}" fire failed: ${error instanceof Error ? error.message : String(error)}`);
+                this.logger(`[bdk] reminder "${record.id}" fire failed: ${error instanceof Error ? error.message : String(error)}`);
                 // Keep recurring reminders alive after unexpected throws.
                 // One-shots stay armed so a failed wake can be retried / dispatched.
                 try {
@@ -760,7 +789,7 @@ export class ReminderRunner {
                     yield this.afterFire(current, "skip");
                 }
                 catch (rescheduleError) {
-                    this.logger(`[agent-sdk] reminder "${record.id}" reschedule after failure failed: ${rescheduleError instanceof Error ? rescheduleError.message : String(rescheduleError)}`);
+                    this.logger(`[bdk] reminder "${record.id}" reschedule after failure failed: ${rescheduleError instanceof Error ? rescheduleError.message : String(rescheduleError)}`);
                 }
             }));
         }, delay);
@@ -818,13 +847,13 @@ export class ReminderRunner {
                         }
                     }
                     catch (error) {
-                        this.logger(`[agent-sdk] reminder "${id}" until() failed: ${error instanceof Error ? error.message : String(error)}`);
+                        this.logger(`[bdk] reminder "${id}" until() failed: ${error instanceof Error ? error.message : String(error)}`);
                     }
                 }
                 if (yield this.isSessionBusy(record.channelId, record.continuationToken)) {
                     if (record.busyPolicy === "skipIfBusy") {
                         yield this.afterFire(record, "skip");
-                        this.logger(`[agent-sdk] reminder "${id}" (${record.purpose}) skipped: session busy`);
+                        this.logger(`[bdk] reminder "${id}" (${record.purpose}) skipped: session busy`);
                         return { outcome: "fired", reason: "skipped_busy" };
                     }
                     yield this.whenSessionIdle(record.channelId, record.continuationToken);
@@ -857,7 +886,7 @@ export class ReminderRunner {
                 if (result.action === "stop") {
                     if (latest !== undefined && latest.status === "armed") {
                         yield this.disarm(latest, "run_stop");
-                        this.logger(`[agent-sdk] reminder "${id}" (${record.purpose}) disarmed: run_stop`);
+                        this.logger(`[bdk] reminder "${id}" (${record.purpose}) disarmed: run_stop`);
                         return { outcome: "fired", reason: "run_stop" };
                     }
                     return {
@@ -870,11 +899,11 @@ export class ReminderRunner {
                 }
                 if (result.action === "skip") {
                     yield this.afterFire(latest, "skip", result.reschedule);
-                    this.logger(`[agent-sdk] reminder "${id}" (${record.purpose}) skipped`);
+                    this.logger(`[bdk] reminder "${id}" (${record.purpose}) skipped`);
                     return { outcome: "fired", reason: "skipped" };
                 }
                 yield this.afterFire(latest, "delivered", result.reschedule);
-                this.logger(`[agent-sdk] reminder "${id}" (${record.purpose}) fired`);
+                this.logger(`[bdk] reminder "${id}" (${record.purpose}) fired`);
                 return { outcome: "fired", reason: "delivered" };
             }
             finally {
@@ -910,14 +939,8 @@ export class ReminderRunner {
      * Follow-ups must use the bound session's principal. If the session is gone,
      * disarm rather than creating a fresh APP_AUTH conversation.
      */
-    resolveFollowupAuth(channelId, continuationToken) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const existing = yield this.engine.sessions.findByContinuation(channelId, continuationToken);
-            if (existing !== undefined) {
-                return existing.auth;
-            }
-            return undefined;
-        });
+    boundSession(record) {
+        return this.engine.sessions.findByContinuation(record.channelId, record.continuationToken);
     }
     deliverPrompt(record) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -933,9 +956,9 @@ export class ReminderRunner {
      */
     resolveFollowupTarget(record) {
         return __awaiter(this, void 0, void 0, function* () {
-            const local = yield this.resolveFollowupAuth(record.channelId, record.continuationToken);
+            const local = yield this.boundSession(record);
             if (local !== undefined) {
-                return { auth: local, reached: "session_joined" };
+                return { auth: local.auth, sessionId: local.sessionId, reached: "session_joined" };
             }
             if (this.hostedGuest === undefined) {
                 return { auth: undefined, reached: "session_gone" };
@@ -946,20 +969,20 @@ export class ReminderRunner {
             if (!restored) {
                 return { auth: undefined, reached: "session_gone" };
             }
-            const auth = yield this.resolveFollowupAuth(record.channelId, record.continuationToken);
-            return auth === undefined
+            const session = yield this.boundSession(record);
+            return session === undefined
                 ? { auth: undefined, reached: "session_unreadable" }
-                : { auth, reached: "session_restored" };
+                : { auth: session.auth, sessionId: session.sessionId, reached: "session_restored" };
         });
     }
     deliverPromptFire(record) {
         return __awaiter(this, void 0, void 0, function* () {
             const target = yield this.resolveFollowupTarget(record);
             if (target.auth !== undefined) {
-                return this.promptDelivery(record, target.auth, target.reached);
+                return this.promptDelivery(record, target, target.reached);
             }
             if (target.reached === "session_unreadable") {
-                this.logger(`[agent-sdk] reminder "${record.id}" (${record.purpose}) durable session did not materialize locally; not opening a new one`);
+                this.logger(`[bdk] reminder "${record.id}" (${record.purpose}) durable session did not materialize locally; not opening a new one`);
                 return { result: { action: "stop" }, reason: "session_gone" };
             }
             if (this.hostedGuest !== undefined &&
@@ -978,7 +1001,7 @@ export class ReminderRunner {
                     };
                 }
                 try {
-                    return yield this.promptDelivery(record, fireAuth, "session_opened");
+                    return yield this.promptDelivery(record, { auth: fireAuth }, "session_opened");
                 }
                 catch (error) {
                     if (!(error instanceof SessionAuthError)) {
@@ -987,7 +1010,7 @@ export class ReminderRunner {
                     // A session landed on this key under another principal between the
                     // lookup and the send. That does not change on retry, so stop
                     // rather than let the control plane re-admit until its attempt cap.
-                    this.logger(`[agent-sdk] reminder "${record.id}" (${record.purpose}) cannot join session on its continuation: ${error.message}`);
+                    this.logger(`[bdk] reminder "${record.id}" (${record.purpose}) cannot join session on its continuation: ${error.message}`);
                     return { result: { action: "stop" }, reason: "session_gone" };
                 }
             }
@@ -999,11 +1022,11 @@ export class ReminderRunner {
             return { result: { action: "stop" }, reason: "session_gone" };
         });
     }
-    promptDelivery(record, auth, delivered) {
+    promptDelivery(record, address, delivered) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
             const settle = {};
-            const result = yield this.sendFollowup(record, buildFirePrompt(record), auth, settle);
+            const result = yield this.sendFollowup(record, buildFirePrompt(record), address, settle);
             return {
                 result,
                 reason: result.action === "skip" ? ((_a = settle.skipReason) !== null && _a !== void 0 ? _a : "busy") : delivered,
@@ -1015,14 +1038,16 @@ export class ReminderRunner {
      * Join the reminder's existing session. Control-plane (`/v2`) channels
      * refuse authored `continuationToken`; pass the stored key as
      * {@link EngineSendOptions.mailboxContinuation} so the engine reuses the
-     * CP-selected identity without channel admission.
+     * CP-selected identity without channel admission. A one-shot key (an HTTP
+     * session's) names the event that opened the session and never joins, so
+     * the follow-up names the bound session itself.
      */
-    followupSendOptions(record, auth) {
+    followupSendOptions(record, address) {
+        const { auth, sessionId } = address;
         if (this.channelUsesControlPlaneContinuation(record.channelId)) {
-            return {
-                auth,
-                mailboxContinuation: { key: record.continuationToken },
-            };
+            return Object.assign({ auth, mailboxContinuation: { key: record.continuationToken } }, (sessionId !== undefined && isOneShotContinuationKey(record.continuationToken)
+                ? { hostedSessionId: sessionId }
+                : {}));
         }
         return {
             auth,
@@ -1061,9 +1086,9 @@ export class ReminderRunner {
             }
         });
     }
-    sendFollowup(record, message, auth, settle, extra) {
+    sendFollowup(record, message, address, settle, extra) {
         return __awaiter(this, void 0, void 0, function* () {
-            const sendOptions = Object.assign(Object.assign({}, this.followupSendOptions(record, auth)), { state: extra === null || extra === void 0 ? void 0 : extra.state, refreshState: extra === null || extra === void 0 ? void 0 : extra.refreshState, title: extra === null || extra === void 0 ? void 0 : extra.title, clearCloudOverride: extra === null || extra === void 0 ? void 0 : extra.clearCloudOverride });
+            const sendOptions = Object.assign(Object.assign({}, this.followupSendOptions(record, address)), { state: extra === null || extra === void 0 ? void 0 : extra.state, refreshState: extra === null || extra === void 0 ? void 0 : extra.refreshState, title: extra === null || extra === void 0 ? void 0 : extra.title, clearCloudOverride: extra === null || extra === void 0 ? void 0 : extra.clearCloudOverride });
             try {
                 const session = yield this.engine.send(record.channelId, message, sendOptions);
                 yield this.settleFollowup(session, settle);
@@ -1084,7 +1109,7 @@ export class ReminderRunner {
                         return { action: "delivered" };
                     }
                     catch (retryError) {
-                        this.logger(`[agent-sdk] reminder "${record.id}" followup failed after wait: ${retryError instanceof Error ? retryError.message : String(retryError)}`);
+                        this.logger(`[bdk] reminder "${record.id}" followup failed after wait: ${retryError instanceof Error ? retryError.message : String(retryError)}`);
                         if (settle !== undefined) {
                             settle.skipReason = "followup_failed";
                         }
@@ -1111,16 +1136,16 @@ export class ReminderRunner {
             followup(args) {
                 return __awaiter(this, void 0, void 0, function* () {
                     const target = yield self.resolveFollowupTarget(record);
-                    let auth = target.auth;
+                    let address = target.auth === undefined ? undefined : target;
                     // `openAuth` opens only when nothing exists anywhere: an unreadable
                     // durable session must not be shadowed by a second one on the same
                     // key (prompt-fire parity).
-                    if (auth === undefined &&
+                    if (address === undefined &&
                         target.reached === "session_gone" &&
                         args.openAuth !== undefined) {
-                        auth = args.openAuth;
+                        address = { auth: args.openAuth };
                     }
-                    if (auth === undefined) {
+                    if (address === undefined) {
                         // Under the CP protocol the guest never writes reminder status;
                         // the fire's `stop` outcome carries the reason instead.
                         if (!self.usesControlPlaneProtocol) {
@@ -1128,11 +1153,11 @@ export class ReminderRunner {
                         }
                         throw new Error(`Reminder "${record.id}" followup: session gone for continuation`);
                     }
-                    const result = yield self.sendFollowup(record, args.message, auth, undefined, args);
+                    const result = yield self.sendFollowup(record, args.message, address, undefined, args);
                     if (result.action === "skip") {
                         throw new Error(`Reminder "${record.id}" followup skipped: session busy`);
                     }
-                    const existing = yield self.engine.sessions.findByContinuation(record.channelId, record.continuationToken);
+                    const existing = yield self.boundSession(record);
                     if (existing === undefined) {
                         throw new Error(`Reminder "${record.id}" followup: session not found for continuation`);
                     }

package/dist/internal/resolve-prod-target.d.ts

@@ -1,6 +1,6 @@
 /**
  * Resolve a hosted (managed) agent-sdk deployment into a base URL +
- * request headers for chat/run/call/eval `--prod`.
+ * request headers for chat/run/call `--prod`.
  *
  * Uses short-lived `engineAccess` from the deployment status route
  * (Cursor API key on the management API; `X-Anyrun-Port-Token` on the
@@ -67,14 +67,6 @@ export interface ResolvedProdPlayground {
 export declare function resolveProdPlaygroundUrl(options: ResolveProdTargetOptions & {
     sessionId?: string;
 }): Promise<ResolvedProdPlayground>;
-/**
- * Look up a running deployment and return its stable alias playground URL.
- * Does not mint `engineAccess` — the browser signs in with the alias token.
- * Throws {@link Error} with a CLI-ready message on failure.
- */
-export declare function resolveProdAliasPlaygroundUrl(options: ResolveProdTargetOptions & {
-    sessionId?: string;
-}): Promise<ResolvedProdAliasPlayground>;
 /** Resolve the deployment slug the same way `deploy` does for a single dir. */
 export declare function resolveProdSlug(options: {
     dir: string;

package/dist/internal/resolve-prod-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-prod-target.d.ts","sourceRoot":"","sources":["../../src/internal/resolve-prod-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,yEAAyE;IACzE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAFxD,YACE,OAAO,EAAE,MAAM,EACN,OAAO,GAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAiB,EAItE;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA6F7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,sBAAsB,CAAC,CAsCjC;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,2BAA2B,CAAC,CAoBtC;AAwDD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgB7F"}
+{"version":3,"file":"resolve-prod-target.d.ts","sourceRoot":"","sources":["../../src/internal/resolve-prod-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,yEAAyE;IACzE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAFxD,YACE,OAAO,EAAE,MAAM,EACN,OAAO,GAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAiB,EAItE;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA2F7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,sBAAsB,CAAC,CAsCjC;AAwDD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgB7F"}

package/dist/internal/resolve-prod-target.js

@@ -1,6 +1,6 @@
 /**
  * Resolve a hosted (managed) agent-sdk deployment into a base URL +
- * request headers for chat/run/call/eval `--prod`.
+ * request headers for chat/run/call `--prod`.
  *
  * Uses short-lived `engineAccess` from the deployment status route
  * (Cursor API key on the management API; `X-Anyrun-Port-Token` on the
@@ -66,8 +66,6 @@ export function resolveProdTarget(options) {
             err,
         });
         if (typeof auth === "number") {
-            // Not "--prod": `eval` resolves the hosted deployment by default,
-            // without any flag.
             throw new Error(`Could not resolve Cursor credentials/team for the hosted deployment (see above).`);
         }
         if (options.skipLegacyArchitectureCheck !== true) {
@@ -172,33 +170,6 @@ export function resolveProdPlaygroundUrl(options) {
         return Object.assign(Object.assign({}, resolved), { architecture });
     });
 }
-/**
- * Look up a running deployment and return its stable alias playground URL.
- * Does not mint `engineAccess` — the browser signs in with the alias token.
- * Throws {@link Error} with a CLI-ready message on failure.
- */
-export function resolveProdAliasPlaygroundUrl(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const err = (_a = options.err) !== null && _a !== void 0 ? _a : ((text) => void process.stderr.write(text));
-        const slug = resolveProdSlug(options);
-        const auth = yield resolveDeployAuth({
-            team: options.team,
-            apiKey: options.apiKey,
-            fetchImpl: options.fetchImpl,
-            err,
-        });
-        if (typeof auth === "number") {
-            throw new Error(`Could not resolve Cursor credentials/team for the hosted deployment (see above).`);
-        }
-        yield rejectV2ForLegacyCommand({
-            client: auth.client,
-            teamId: auth.teamId,
-            slug,
-        });
-        return resolveProdAliasPlaygroundUrlWithAuth(options, auth, slug, err);
-    });
-}
 function resolveProdAliasPlaygroundUrlWithAuth(options, auth, slug, err) {
     return __awaiter(this, void 0, void 0, function* () {
         let detail;

package/dist/internal/resolved-connections.js

@@ -26,7 +26,7 @@ export function validateMountConnectionsConfig(args) {
     if (filteredRefs.length === 0) {
         return;
     }
-    throw new Error(`[agent-sdk] agent "${label}" has Cursor account MCP connections with \`servers\` filters (${filteredRefs
+    throw new Error(`[bdk] agent "${label}" has Cursor account MCP connections with \`servers\` filters (${filteredRefs
         .map(ref => ref.name)
         .join(", ")}) but no --public-url; cloud-runtime turns cannot honor those filters without a public bridge URL. Set --public-url or remove the \`servers\` filter.`);
 }
@@ -41,7 +41,7 @@ export function assertCloudCanHonorAccountServersFilters(args) {
     if (blocked.length === 0) {
         return;
     }
-    throw new Error(`[agent-sdk] cloud turn cannot honor Cursor account \`servers\` filters (${blocked
+    throw new Error(`[bdk] cloud turn cannot honor Cursor account \`servers\` filters (${blocked
         .map(connection => connection.name)
         .join(", ")}) without --public-url; set --public-url so cloud turns reach the filtered account bridge instead of falling back to native connectors.`);
 }
@@ -53,7 +53,7 @@ export function assertAccountConnectionsNotAnonymous(args) {
     if (args.allowAnonymousCursorAccountMcp === true) {
         return;
     }
-    throw new Error("[agent-sdk] --allow-anonymous cannot be used with Cursor account MCP connections (defineConnection({ cursorAccount: true })); use --bearer-token, or opt in with --allow-anonymous-cursor-account-mcp behind a trusted boundary.");
+    throw new Error("[bdk] --allow-anonymous cannot be used with Cursor account MCP connections (defineConnection({ cursorAccount: true })); use --bearer-token, or opt in with --allow-anonymous-cursor-account-mcp behind a trusted boundary.");
 }
 export function resolveMountConnections(args) {
     const agent = args.project.agent;
@@ -66,15 +66,15 @@ export function resolveMountConnections(args) {
             .map(connection => connection.name);
         if (hostOauthNames.length > 0) {
             args.logger(args.cloudToolsBridge === true
-                ? `[agent-sdk] agent "${label}": host-OAuth MCP connections (${hostOauthNames.join(", ")}) reach cloud turns through the host connection bridge; their tokens stay on this serve host.`
-                : `[agent-sdk] warning: agent "${label}" has host-OAuth MCP connections (${hostOauthNames.join(", ")}) whose tokens live on this serve host; cloud-runtime turns omit them. Serve with a cloud tools URL so they reach turns through the host connection bridge, or drop \`oauth\` and authorize the server another way.`);
+                ? `[bdk] agent "${label}": host-OAuth MCP connections (${hostOauthNames.join(", ")}) reach cloud turns through the host connection bridge; their tokens stay on this serve host.`
+                : `[bdk] warning: agent "${label}" has host-OAuth MCP connections (${hostOauthNames.join(", ")}) whose tokens live on this serve host; cloud-runtime turns omit them. Serve with a cloud tools URL so they reach turns through the host connection bridge, or drop \`oauth\` and authorize the server another way.`);
         }
     }
     if (args.peerRefs !== undefined && args.peerRefs.length > 0) {
         const peers = resolvePeerConnections(Object.assign(Object.assign({ refs: args.peerRefs, serverUrl: args.serverUrl }, (args.publicUrl === undefined ? {} : { publicUrl: args.publicUrl })), (args.authToken === undefined ? {} : { authToken: args.authToken })));
         resolved.push(...peers);
         if (cloudCapable && args.publicUrl === undefined) {
-            args.logger(`[agent-sdk] warning: agent "${label}" has peer MCP connections (${peers
+            args.logger(`[bdk] warning: agent "${label}" has peer MCP connections (${peers
                 .map(peer => peer.name)
                 .join(", ")}) but no --public-url; cloud-runtime turns cannot reach this host's loopback address, so peers are omitted from cloud turns.`);
         }
@@ -85,8 +85,8 @@ export function resolveMountConnections(args) {
         args.accountBridge.logPreflight(args.accountRefs);
         if (cloudCapable && args.publicUrl === undefined) {
             args.logger(args.cloudToolsBridge === true
-                ? `[agent-sdk] agent "${label}": cloud-runtime turns reach filtered account connections through the host connection bridge (unfiltered ones fall back to the account's native connectors).`
-                : `[agent-sdk] agent "${label}": cloud-runtime turns omit the account bridge without --public-url (cloud agents fall back to the account's native connectors).`);
+                ? `[bdk] agent "${label}": cloud-runtime turns reach filtered account connections through the host connection bridge (unfiltered ones fall back to the account's native connectors).`
+                : `[bdk] agent "${label}": cloud-runtime turns omit the account bridge without --public-url (cloud agents fall back to the account's native connectors).`);
         }
     }
     return resolved;

package/dist/internal/run-client.d.ts

@@ -11,12 +11,22 @@ import { type Trajectory } from "./trajectory.js";
 /** Thrown when a turn stream exceeds `timeoutMs`; carries the session id. */
 export declare class RunSessionTimeoutError extends Error {
     readonly sessionId: string;
-    constructor(message: string, sessionId: string);
+    /** Events the turn recorded before the deadline. */
+    readonly events: SessionEvent[];
+    constructor(message: string, sessionId: string, 
+    /** Events the turn recorded before the deadline. */
+    events: SessionEvent[]);
 }
 export interface RunClientOptions extends RequestAuth {
     baseUrl: string;
     /** Abort a hung turn. */
     timeoutMs?: number;
+    /**
+     * Longest any single read may stay silent: a quiet stream connection ends
+     * so the session's durable log can settle the turn, and each log read is
+     * bounded. Default 5s.
+     */
+    stallMs?: number;
     /** External cancel (combined with {@link timeoutMs} when both are set). */
     signal?: AbortSignal;
     /** Called for each stream event as it arrives (for CLI progress). */

package/dist/internal/run-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-client.d.ts","sourceRoot":"","sources":["../../src/internal/run-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5B,YACE,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EAI3B;CACF;AACD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gEAAgE;IAChE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,GACA,OAAO,CAAC,gBAAgB,CAAC,CAyD3B"}
+{"version":3,"file":"run-client.d.ts","sourceRoot":"","sources":["../../src/internal/run-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtF,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE;IAJjC,YACE,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM;IAC1B,oDAAoD;IAC3C,MAAM,EAAE,YAAY,EAAE,EAIhC;CACF;AACD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gEAAgE;IAChE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,GACA,OAAO,CAAC,gBAAgB,CAAC,CA0D3B"}