@cursor/bdk 0.2.17 → 0.2.20

package/dist/internal/event-log.js

@@ -68,7 +68,7 @@ export class SessionEventLog {
         /** Appended events whose `appendFile` has not finished. */
         this.inflight = [];
         /**
-         * In-process patches (cloud cost backfill) that are not rewritten to
+         * In-process patches (cloud usage backfill) that are not rewritten to
          * `events.ndjson`. Applied on read.
          */
         this.replacements = new Map();
@@ -174,7 +174,7 @@ export class SessionEventLog {
     }
     /**
      * Replace one already-recorded event in this process. Used to backfill
-     * usage/cost onto historical `turn.completed` rows without rewriting
+     * usage onto historical `turn.completed` rows without rewriting
      * `events.ndjson`. Live subscribers are not notified — patch before
      * opening a replay stream.
      */

package/dist/internal/http-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,aAAa,EACd,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAK7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CA+chB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAYtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAErF;AAkFD,8FAA8F;AAC9F,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}
+{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,aAAa,EACd,MAAM,aAAa,CAAC;AAMrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAK7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CAgehB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAYtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAErF;AAkFD,8FAA8F;AAC9F,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}

package/dist/internal/http-channel.js

@@ -12,6 +12,7 @@
 import { samePrincipal } from "./auth.js";
 import { formatContinuationToken, parseContinuationToken } from "./ids.js";
 import { isRecord } from "./is-record.js";
+import { InvalidModelConfigError, modelConfigForDryRun } from "./model-config.js";
 import { isLoopbackAddress } from "./net.js";
 import { ApprovalInterruptedError, ApprovalNotFoundError, AuthInterruptedError, AuthNotFoundError, HTTP_CHANNEL_ID, SessionAuthError, } from "./session-engine.js";
 import { eventsUrlForSession, playgroundUrlForSession } from "./session-urls.js";
@@ -40,6 +41,15 @@ export function buildHttpChannelRoutes(args) {
             if (body.asOf !== undefined && typeof body.asOf !== "string") {
                 return errorResponse(400, "invalid_request", "`asOf` must be an ISO-8601 instant with a timezone when provided.");
             }
+            let modelConfig;
+            try {
+                modelConfig = modelConfigForDryRun(body.modelConfig, body.dryRun === true ? true : undefined);
+            }
+            catch (error) {
+                if (!(error instanceof InvalidModelConfigError))
+                    throw error;
+                return errorResponse(400, "invalid_request", error.message);
+            }
             const message = await transformMessage(body.message, ctx.auth);
             const workspaceFiles = readWorkspaceFiles(body.workspaceFiles);
             // Per-session cloud attach (create only). Eval harness uses this to pin
@@ -51,6 +61,7 @@ export function buildHttpChannelRoutes(args) {
                 ...(body.purpose === "eval" ? { purpose: "eval" } : {}),
                 ...(body.dryRun === true ? { dryRun: true } : {}),
                 asOf: body.asOf,
+                modelConfig,
                 ...(workspaceFiles === undefined ? {} : { workspaceFiles }),
                 ...(cloud === undefined ? {} : { cloud }),
             });
@@ -98,7 +109,15 @@ export function buildHttpChannelRoutes(args) {
                 return errorResponse(409, "stale_continuation_token", "The continuation token does not address this session's active continuation.");
             }
             const message = await transformMessage(body.message, ctx.auth);
-            const rotated = await engine.followUpHttp(sessionId, presented, message);
+            let rotated;
+            try {
+                rotated = await engine.followUpHttp(sessionId, presented, message, body.modelConfig);
+            }
+            catch (error) {
+                if (!(error instanceof InvalidModelConfigError))
+                    throw error;
+                return errorResponse(400, "invalid_request", error.message);
+            }
             if (rotated === undefined) {
                 return errorResponse(409, "stale_continuation_token", "The continuation token does not address this session's active continuation.");
             }
@@ -172,7 +191,7 @@ export function buildHttpChannelRoutes(args) {
             const url = new URL(request.url);
             const asJson = url.searchParams.get("format") === "json";
             const snapshot = await engine.listEvents(sessionId, 0, {
-                backfillCloudCost: true,
+                backfillCloudUsage: true,
             });
             if (asJson) {
                 return jsonResponse({

package/dist/internal/http-control-plane-session.d.ts

@@ -3,7 +3,7 @@
  *
  * `agent-sdk run --prod` reaches the authenticated CP start route, which
  * delivers `agentsdk.session` to the built-in `http` channel of every v2
- * agent. The wake is `send(message, { dryRun, asOf })`; the session id,
+ * agent. The wake is `send(message, { dryRun, asOf, modelConfig, instructions })`; the session id,
  * when the caller resumed an explicit `ses_…`, arrives through the hosted
  * execution (never through this payload), so authored code cannot pick
  * one. {@link HttpChannelDefinition.onAdmit} runs against the mailbox
@@ -13,11 +13,14 @@
  * hosted execution runs the case body there instead of a single turn. The
  * case body writes every message, so it skips `onAdmit` and `onMessage`.
  */
-import type { ChannelHandlerArgs, HttpChannelDefinition, SendMessageOptions } from "../types.js";
+import type { ChannelHandlerArgs, HttpChannelDefinition, SendMessageOptions, SessionModelConfig } from "../types.js";
 export type ControlPlaneSessionPayload = {
     message: string;
     dryRun?: boolean | undefined;
     asOf?: string | undefined;
+    modelConfig?: SessionModelConfig | undefined;
+    /** Dry-run replacement for the agent's instructions.md. */
+    instructions?: string | undefined;
 };
 export type EvalCaseRef = {
     runId: string;

package/dist/internal/http-control-plane-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-control-plane-session.d.ts","sourceRoot":"","sources":["../../src/internal/http-control-plane-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAUjG,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAY5D,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAE/E;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4B/E;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBhE;AAeD,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BpB;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAavF"}
+{"version":3,"file":"http-control-plane-session.d.ts","sourceRoot":"","sources":["../../src/internal/http-control-plane-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7C,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAe5D,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAE/E;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0D/E;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBhE;AAeD,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgCpB;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAavF"}

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

@@ -3,7 +3,7 @@
  *
  * `agent-sdk run --prod` reaches the authenticated CP start route, which
  * delivers `agentsdk.session` to the built-in `http` channel of every v2
- * agent. The wake is `send(message, { dryRun, asOf })`; the session id,
+ * agent. The wake is `send(message, { dryRun, asOf, modelConfig, instructions })`; the session id,
  * when the caller resumed an explicit `ses_…`, arrives through the hosted
  * execution (never through this payload), so authored code cannot pick
  * one. {@link HttpChannelDefinition.onAdmit} runs against the mailbox
@@ -17,9 +17,12 @@ import { skipped, turnStarted } from "./channel-dispatch.js";
 import { attachHostedAdmissionAdapter } from "./hosted-admission-adapter.js";
 import { AGENT_SDK_EVAL_CASE_EVENT_TYPE, AGENT_SDK_HTTP_CHANNEL_KIND, AGENT_SDK_SESSION_EVENT_TYPE, } from "./hosted-catch-protocol.js";
 import { isRecord } from "./is-record.js";
-const PAYLOAD_KEYS = new Set(["message", "dryRun", "asOf"]);
+import { InvalidModelConfigError, modelConfigForDryRun } from "./model-config.js";
+const PAYLOAD_KEYS = new Set(["message", "dryRun", "asOf", "modelConfig", "instructions"]);
 const EVAL_CASE_PAYLOAD_KEYS = new Set(["runId", "caseId"]);
 const MAX_MESSAGE_CHARS = 64 * 1024;
+const MAX_INSTRUCTIONS_CHARS = 256 * 1024;
+const INSTRUCTIONS_REQUIRE_DRY_RUN = "invalid argument: instructions is only allowed when dryRun is true";
 const MAX_EVAL_ID_CHARS = 512;
 /** Symbol-keyed so authored channels cannot forge an eval-case send. */
 const EVAL_CASE = Symbol("agentsdk.eval-case");
@@ -45,12 +48,41 @@ export function parseControlPlaneSessionPayload(payload) {
         (typeof payload.asOf !== "string" || payload.asOf.trim().length === 0)) {
         return { ok: false, error: "payload.asOf must be a non-empty string" };
     }
+    let modelConfig;
+    if (payload.modelConfig !== undefined) {
+        try {
+            modelConfig = modelConfigForDryRun(payload.modelConfig, payload.dryRun === true ? true : undefined);
+        }
+        catch (error) {
+            if (!(error instanceof InvalidModelConfigError))
+                throw error;
+            return { ok: false, error: error.message };
+        }
+    }
+    let instructions;
+    if (payload.instructions !== undefined) {
+        if (typeof payload.instructions !== "string") {
+            return { ok: false, error: "payload.instructions must be a string" };
+        }
+        instructions = payload.instructions.trim();
+        if (instructions.length === 0) {
+            return { ok: false, error: "payload.instructions must be a non-empty string" };
+        }
+        if (instructions.length > MAX_INSTRUCTIONS_CHARS) {
+            return { ok: false, error: "payload.instructions is too long" };
+        }
+        if (payload.dryRun !== true) {
+            return { ok: false, error: INSTRUCTIONS_REQUIRE_DRY_RUN };
+        }
+    }
     return {
         ok: true,
         data: {
             message,
             dryRun: payload.dryRun === true ? true : undefined,
             asOf: typeof payload.asOf === "string" ? payload.asOf.trim() : undefined,
+            modelConfig,
+            instructions,
         },
     };
 }
@@ -102,6 +134,8 @@ export async function dispatchHttpControlPlaneSession(input) {
             sessionKey: input.mailboxContinuationKey,
             dryRun: parsed.data.dryRun,
             asOf: parsed.data.asOf,
+            modelConfig: parsed.data.modelConfig,
+            instructions: parsed.data.instructions,
             host: input.args.host,
         });
     }
@@ -109,6 +143,8 @@ export async function dispatchHttpControlPlaneSession(input) {
     const session = await input.args.send(message, {
         dryRun: parsed.data.dryRun,
         asOf: parsed.data.asOf,
+        modelConfig: parsed.data.modelConfig,
+        instructions: parsed.data.instructions,
     });
     return turnStarted(session);
 }

package/dist/internal/init-scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-scaffold.d.ts","sourceRoot":"","sources":["../../src/internal/init-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAkBvE;AAED,eAAO,MAAM,SAAS,EAAE,MAOZ,CAAC;AAgBb,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAgBzD;AAcD,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAK7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAS3B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,WAAmB,GAAG,MAAM,CA0C/E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuBtF;AAWD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,EAAE,MAUlC,CAAC;AAWF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EACpE,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,WAAmB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"init-scaffold.d.ts","sourceRoot":"","sources":["../../src/internal/init-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAkBvE;AAED,eAAO,MAAM,SAAS,EAAE,MAOZ,CAAC;AAgBb,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAgBzD;AAcD,eAAO,MAAM,SAAS,EAAE,MAMvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAK7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAS3B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,WAAmB,GAAG,MAAM,CA0C/E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuBtF;AAWD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,EAAE,MAUlC,CAAC;AAWF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EACpE,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,WAAmB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/internal/init-scaffold.js

@@ -67,10 +67,9 @@ export default defineTool({
   },
 });
 `;
-export const MEMORY_TS = `// Journals every turn (timestamp, session, user message, result) so
-// future sessions can recall past work. The journal is shared across every
-// session — and every user — of this agent. Pass your own MemoryBackend to
-// change where memories live, or delete this file to opt out.
+export const MEMORY_TS = `// Every session and every user of this agent share one memory journal.
+// To turn memory off, delete this file and the "## Memory" section of
+// instructions.md.
 import { memoryHook } from "${PACKAGE_NAME}/memory";
 
 export default memoryHook();

package/dist/internal/model-config.d.ts

@@ -0,0 +1,7 @@
+import type { SessionModelConfig } from "../types.js";
+export declare const MODEL_CONFIG_REQUIRES_DRY_RUN = "invalid argument: modelConfig requires dryRun";
+export declare class InvalidModelConfigError extends Error {
+    constructor(message: string);
+}
+export declare function modelConfigForDryRun(modelConfig: unknown, dryRun: boolean | undefined): SessionModelConfig | undefined;
+//# sourceMappingURL=model-config.d.ts.map

package/dist/internal/model-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.d.ts","sourceRoot":"","sources":["../../src/internal/model-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,eAAO,MAAM,6BAA6B,kDAAkD,CAAC;AAE7F,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAyCD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,OAAO,GAAG,SAAS,GAC1B,kBAAkB,GAAG,SAAS,CAehC"}

package/dist/internal/model-config.js

@@ -0,0 +1,67 @@
+import { isRecord } from "./is-record.js";
+const MODEL_ID = /^[a-z0-9][a-z0-9.-]{0,127}$/;
+const LEVELS = new Set(["low", "medium", "high", "xhigh"]);
+export const MODEL_CONFIG_REQUIRES_DRY_RUN = "invalid argument: modelConfig requires dryRun";
+export class InvalidModelConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidModelConfigError";
+    }
+}
+function invalid(message) {
+    throw new InvalidModelConfigError(message);
+}
+function setting(value, where) {
+    if (!isRecord(value))
+        invalid(`invalid argument: ${where}.id is not a model id`);
+    const id = value.id;
+    if (typeof id !== "string" || !MODEL_ID.test(id)) {
+        invalid(`invalid argument: ${where}.id is not a model id`);
+    }
+    const rawParams = value.params;
+    if (!Array.isArray(rawParams))
+        invalid(`invalid argument: ${where} requires params`);
+    const effortId = id.includes("gpt") ? "reasoning" : "effort";
+    const params = [];
+    const seen = new Set();
+    for (const param of rawParams) {
+        if (!isRecord(param))
+            invalid(`invalid argument: ${where} param "" is not allowed`);
+        const paramId = typeof param.id === "string" ? param.id : "";
+        const paramValue = typeof param.value === "string" ? param.value : "";
+        if (paramId === "" ||
+            paramValue === "" ||
+            (paramId !== effortId && paramId !== "fast") ||
+            seen.has(paramId)) {
+            invalid(`invalid argument: ${where} param ${JSON.stringify(paramId)} is not allowed`);
+        }
+        const valueOk = paramId === "fast" ? paramValue === "true" || paramValue === "false" : LEVELS.has(paramValue);
+        if (!valueOk)
+            invalid(`invalid argument: ${where} param ${JSON.stringify(paramId)} bad value`);
+        seen.add(paramId);
+        params.push({ id: paramId, value: paramValue });
+    }
+    if (!seen.has(effortId) || !seen.has("fast")) {
+        invalid(`invalid argument: ${where} requires params ${effortId} and fast`);
+    }
+    return { id, params };
+}
+export function modelConfigForDryRun(modelConfig, dryRun) {
+    if (modelConfig === undefined)
+        return undefined;
+    if (dryRun !== true)
+        invalid(MODEL_CONFIG_REQUIRES_DRY_RUN);
+    if (!isRecord(modelConfig)) {
+        invalid("invalid argument: modelConfig must be { model, fallbacks? }");
+    }
+    const model = setting(modelConfig.model, "modelConfig.model");
+    const fallbacks = modelConfig.fallbacks;
+    if (fallbacks === undefined)
+        return { model, fallbacks: [] };
+    if (!Array.isArray(fallbacks))
+        invalid("invalid argument: modelConfig.fallbacks must be an array");
+    return {
+        model,
+        fallbacks: fallbacks.map((item, i) => setting(item, `modelConfig.fallbacks[${i}]`)),
+    };
+}

package/dist/internal/otel/collector.d.ts

@@ -2,9 +2,9 @@
  * Maps the durable session event stream onto OTel traces / metrics / logs.
  *
  * Attribute names reuse Cursor enterprise wire keys where they overlap
- * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`,
- * `cursor.cost.usage`, `cursor.model.name`) so Agent SDK traces join org
- * metrics/logs in the same collector. Agent-SDK-only fields use `agent_sdk.*`.
+ * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`) so Agent SDK
+ * traces join org metrics/logs in the same collector. Agent-SDK-only fields
+ * use `agent_sdk.*`.
  */
 import type { SessionEvent, SessionInfo } from "../../types.js";
 import { type AttrValue } from "./attrs.js";

package/dist/internal/otel/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E,0FAA0F;IAC1F,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,yEAAyE;IACzE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IACrF,mEAAmE;IACnE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAChF;AAiBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,aAAa,CA0yBf"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E,0FAA0F;IAC1F,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,yEAAyE;IACzE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IACrF,mEAAmE;IACnE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAChF;AAiBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,aAAa,CA2xBf"}

package/dist/internal/otel/collector.js

@@ -2,14 +2,15 @@
  * Maps the durable session event stream onto OTel traces / metrics / logs.
  *
  * Attribute names reuse Cursor enterprise wire keys where they overlap
- * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`,
- * `cursor.cost.usage`, `cursor.model.name`) so Agent SDK traces join org
- * metrics/logs in the same collector. Agent-SDK-only fields use `agent_sdk.*`.
+ * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`) so Agent SDK
+ * traces join org metrics/logs in the same collector. Agent-SDK-only fields
+ * use `agent_sdk.*`.
  */
 import { context, ROOT_CONTEXT, SpanKind, SpanStatusCode, trace, } from "@opentelemetry/api";
 import { SeverityNumber } from "@opentelemetry/api-logs";
 import { classifyExpectedDeliveryFailure } from "../expected-delivery-failure.js";
 import { attrs } from "./attrs.js";
+import { computerUseRequestAttrs, computerUseResultAttrs } from "./computer-use-attrs.js";
 const CONTENT_MAX = 2_048;
 export function createOtelCollector(runtime, agentName, log) {
     const sessions = new Map();
@@ -206,6 +207,7 @@ export function createOtelCollector(runtime, agentName, log) {
                 const status = event.data.isError ? "failure" : "success";
                 if (span !== undefined) {
                     span.setAttribute("cursor.tool.status", status);
+                    span.setAttributes(attrs(computerUseResultAttrs(event.data.toolName, event.data.output)));
                     if (logOpts?.toolContent === true && event.data.output !== undefined) {
                         span.setAttribute("agent_sdk.tool_output", truncate(json(event.data.output)));
                     }
@@ -300,7 +302,6 @@ export function createOtelCollector(runtime, agentName, log) {
                 }
                 endOpenChildren(turn, startTime);
                 const usage = event.data.usage;
-                const cost = event.data.cost;
                 if (usage !== undefined) {
                     turn.span.setAttributes(attrs({
                         "agent_sdk.usage.input_tokens": usage.inputTokens,
@@ -311,17 +312,6 @@ export function createOtelCollector(runtime, agentName, log) {
                     }));
                     recordTokens(event.sessionId, usage);
                 }
-                if (cost !== undefined) {
-                    turn.span.setAttributes(attrs({
-                        "cursor.model.name": cost.model,
-                        "agent_sdk.cost_usd": cost.totalUsd,
-                        "agent_sdk.cost_source": cost.source,
-                    }));
-                    metrics?.cost.add(cost.totalUsd, join(event.sessionId, {
-                        "cursor.model.name": cost.model,
-                        "agent_sdk.agent": agentName,
-                    }));
-                }
                 turn.span.setStatus({ code: SpanStatusCode.OK });
                 turn.span.end(startTime);
                 sessions.get(event.sessionId)?.turns.delete(event.turnId);
@@ -333,8 +323,6 @@ export function createOtelCollector(runtime, agentName, log) {
                     ...baseLog(event, session),
                     "agent_sdk.usage.input_tokens": usage?.inputTokens,
                     "agent_sdk.usage.output_tokens": usage?.outputTokens,
-                    "agent_sdk.cost_usd": cost?.totalUsd,
-                    "cursor.model.name": cost?.model,
                 }));
                 return;
             }
@@ -476,6 +464,7 @@ export function createOtelCollector(runtime, agentName, log) {
         return trace.setSpan(context.active(), turn.span);
     }
     function openToolSpan(args) {
+        const computerUseAttrs = computerUseRequestAttrs(args.call.toolName, args.call.args);
         const existing = args.turn.tools.get(args.call.callId);
         if (existing !== undefined) {
             // Early `runInCall` opens with callId/toolName only. Fill in
@@ -483,6 +472,7 @@ export function createOtelCollector(runtime, agentName, log) {
             // The OTel parent is fixed at start; `parent_call_id` still records
             // the event-stream hierarchy for nested/subagent calls.
             existing.setAttributes(join(args.sessionId, {
+                ...computerUseAttrs,
                 "agent_sdk.parent_call_id": args.parentCallId ?? args.call.parentCallId,
                 "agent_sdk.tool_args": logOpts?.toolContent === true && args.call.args !== undefined
                     ? truncate(json(args.call.args))
@@ -504,6 +494,7 @@ export function createOtelCollector(runtime, agentName, log) {
                 "agent_sdk.tool_args": logOpts?.toolContent === true && args.call.args !== undefined
                     ? truncate(json(args.call.args))
                     : undefined,
+                ...computerUseAttrs,
             }),
         }, parentCtxFor(args.turn, args.parentCallId ?? args.call.parentCallId));
         args.turn.tools.set(args.call.callId, span);
@@ -668,10 +659,6 @@ function buildMetrics(meter) {
             description: "Token usage by type",
             unit: "{token}",
         }),
-        cost: meter.createCounter("cursor.cost.usage", {
-            description: "Estimated turn cost in USD",
-            unit: "USD",
-        }),
     };
 }
 function truncate(value) {

package/dist/internal/otel/computer-use-attrs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Content-free span attributes for `computerUse` tool calls.
+ *
+ * Computer use args hold typed text and screen coordinates, so the collector
+ * exports them only under `toolContent`. These attributes keep the batch
+ * shape visible without that opt-in.
+ */
+import type { AttrValue } from "./attrs.js";
+type Attrs = Record<string, AttrValue | undefined>;
+export declare function computerUseRequestAttrs(toolName: string, args: unknown): Attrs;
+export declare function computerUseResultAttrs(toolName: string, output: unknown): Attrs;
+export {};
+//# sourceMappingURL=computer-use-attrs.d.ts.map

package/dist/internal/otel/computer-use-attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-use-attrs.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/computer-use-attrs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAEnD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAa9E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,CAU/E"}

package/dist/internal/otel/computer-use-attrs.js

@@ -0,0 +1,29 @@
+/**
+ * Content-free span attributes for `computerUse` tool calls.
+ *
+ * Computer use args hold typed text and screen coordinates, so the collector
+ * exports them only under `toolContent`. These attributes keep the batch
+ * shape visible without that opt-in.
+ */
+import { isRecord } from "../is-record.js";
+export function computerUseRequestAttrs(toolName, args) {
+    if (toolName !== "computerUse" || !isRecord(args) || !Array.isArray(args.actions)) {
+        return {};
+    }
+    // The SDK adapter emits only known action types, so `type` is a fixed
+    // literal and carries no content.
+    const types = args.actions.map((action) => isRecord(action) && typeof action.type === "string" ? action.type : "other");
+    return {
+        "agent_sdk.computer.action_count": types.length,
+        "agent_sdk.computer.actions": types.join(","),
+    };
+}
+export function computerUseResultAttrs(toolName, output) {
+    if (toolName !== "computerUse" || !isRecord(output)) {
+        return {};
+    }
+    return {
+        "agent_sdk.computer.completed_action_count": typeof output.actionCount === "number" ? output.actionCount : undefined,
+        "agent_sdk.computer.executor_duration_ms": typeof output.durationMs === "number" ? output.durationMs : undefined,
+    };
+}

package/dist/internal/peer-connections.d.ts

@@ -9,6 +9,9 @@
  * server URL. Cloud-runtime turns run on a VM that cannot reach loopback,
  * so they use the serve `publicUrl` when configured — and omit the peer
  * (with a startup warning) when it is not.
+ *
+ * A single-agent serve has no peers mounted beside it. Given a peers URL,
+ * it resolves every peer there for both runtimes instead of omitting them.
  */
 import { type AgentProject } from "../types.js";
 import type { EngineResolvedConnection } from "./session-engine.js";
@@ -21,23 +24,19 @@ export interface PeerConnectionRef {
 }
 /** Every peer connection an agent declares, host connections included. */
 export declare function peerConnectionRefs(project: AgentProject): PeerConnectionRef[];
-/**
- * Deploy slugs of every peer an agent declares, deduped and sorted.
- * `bdk deploy` lowercases directory names into slugs, so
- * `{ agent: "Builder" }` names the `builder` deployment.
- */
+/** Deploy slugs of every peer an agent declares, deduped and sorted. */
 export declare function peerDeploySlugs(project: AgentProject): string[];
 /**
  * Validate every peer MCP connection across `mounts` and return them grouped by
  * the referencing mount's slug. Throws on references to unknown slugs and on
  * self-references (an agent asking itself recurses forever). A single-mode
- * serve, as on every hosted deploy, mounts no other agents, so its peers are
- * omitted with a warning instead of failing boot.
+ * serve mounts no other agents: with a `peersUrl` its peers resolve there,
+ * and without one they are omitted with a warning instead of failing boot.
  */
 export declare function collectPeerConnections(mounts: Array<{
     slug: string;
     project: AgentProject;
-}>, logger: (line: string) => void): Map<string, PeerConnectionRef[]>;
+}>, logger: (line: string) => void, peersUrl?: string): Map<string, PeerConnectionRef[]>;
 /**
  * Resolve validated peer refs to concrete MCP URLs once the server is
  * listening. `serverUrl` is the loopback base (`http://127.0.0.1:<port>`);
@@ -51,4 +50,14 @@ export declare function resolvePeerConnections(args: {
     publicUrl?: string;
     authToken?: string;
 }): EngineResolvedConnection[];
+/**
+ * Resolve a single-agent serve's peers against a host that serves each agent
+ * at `<peersUrl>/<slug>/v1/mcp`. Local and cloud turns share the URL. The
+ * bearer is the Cursor API key bound to this host, expanded each time a
+ * client opens, so a key bound after listen still authenticates.
+ */
+export declare function resolveHostedPeerConnections(args: {
+    refs: PeerConnectionRef[];
+    peersUrl: string;
+}): EngineResolvedConnection[];
 //# sourceMappingURL=peer-connections.d.ts.map

package/dist/internal/peer-connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peer-connections.d.ts","sourceRoot":"","sources":["../../src/internal/peer-connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,aAAa,CAAC;AAE3E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAK7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,EACtD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAgClC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,wBAAwB,EAAE,CAa7B"}
+{"version":3,"file":"peer-connections.d.ts","sourceRoot":"","sources":["../../src/internal/peer-connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,aAAa,CAAC;AAE3E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAK7E;AAUD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,EACtD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAyClC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,wBAAwB,EAAE,CAa7B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,wBAAwB,EAAE,CAW7B"}

package/dist/internal/peer-connections.js

@@ -9,6 +9,9 @@
  * server URL. Cloud-runtime turns run on a VM that cannot reach loopback,
  * so they use the serve `publicUrl` when configured — and omit the peer
  * (with a startup warning) when it is not.
+ *
+ * A single-agent serve has no peers mounted beside it. Given a peers URL,
+ * it resolves every peer there for both runtimes instead of omitting them.
  */
 import { isPeerConnectionTransport } from "../types.js";
 import { MCP_ENDPOINT_PATH } from "./mcp-endpoint.js";
@@ -17,30 +20,40 @@ export function peerConnectionRefs(project) {
     return [...project.agent.connections, ...(project.agent.hostConnections ?? [])].flatMap(({ name, transport }) => isPeerConnectionTransport(transport) ? [{ name, targetSlug: transport.agent }] : []);
 }
 /**
- * Deploy slugs of every peer an agent declares, deduped and sorted.
- * `bdk deploy` lowercases directory names into slugs, so
- * `{ agent: "Builder" }` names the `builder` deployment.
+ * The slug a deployed peer answers to. `bdk deploy` lowercases directory
+ * names into slugs, so `{ agent: "Builder" }` names the `builder` deployment.
  */
+function peerDeploySlug(targetSlug) {
+    return targetSlug.toLowerCase();
+}
+/** Deploy slugs of every peer an agent declares, deduped and sorted. */
 export function peerDeploySlugs(project) {
-    const slugs = peerConnectionRefs(project).map(({ targetSlug }) => targetSlug.toLowerCase());
+    const slugs = peerConnectionRefs(project).map(({ targetSlug }) => peerDeploySlug(targetSlug));
     return [...new Set(slugs)].sort();
 }
 /**
  * Validate every peer MCP connection across `mounts` and return them grouped by
  * the referencing mount's slug. Throws on references to unknown slugs and on
  * self-references (an agent asking itself recurses forever). A single-mode
- * serve, as on every hosted deploy, mounts no other agents, so its peers are
- * omitted with a warning instead of failing boot.
+ * serve mounts no other agents: with a `peersUrl` its peers resolve there,
+ * and without one they are omitted with a warning instead of failing boot.
  */
-export function collectPeerConnections(mounts, logger) {
+export function collectPeerConnections(mounts, logger, peersUrl) {
     const [solo] = mounts;
     if (mounts.length === 1 && solo?.slug === "") {
-        const names = peerConnectionRefs(solo.project).map(({ name }) => name);
-        if (names.length > 0) {
-            logger(`[bdk] warning: agent "${solo.project.name}" has peer MCP connections (${names.join(", ")}) but --mode single mounts no other agents, so they are omitted; peers resolve only in multi-agent serve.`);
+        const refs = peerConnectionRefs(solo.project);
+        if (refs.length === 0) {
+            return new Map();
         }
+        if (peersUrl !== undefined) {
+            return new Map([["", refs]]);
+        }
+        logger(`[bdk] warning: agent "${solo.project.name}" has peer MCP connections (${refs.map(({ name }) => name).join(", ")}) but --mode single mounts no other agents, so they are omitted; peers resolve only in multi-agent serve.`);
         return new Map();
     }
+    if (peersUrl !== undefined) {
+        throw new Error("--peers-url resolves the peers of a single-agent serve (--mode single); a multi-agent serve resolves them among its mounted agents.");
+    }
     const knownSlugs = new Set(mounts.map(({ slug }) => slug));
     const bySlug = new Map();
     for (const { slug, project } of mounts) {
@@ -79,6 +92,24 @@ export function resolvePeerConnections(args) {
         ...(headers === undefined ? {} : { headers }),
     }));
 }
+/**
+ * Resolve a single-agent serve's peers against a host that serves each agent
+ * at `<peersUrl>/<slug>/v1/mcp`. Local and cloud turns share the URL. The
+ * bearer is the Cursor API key bound to this host, expanded each time a
+ * client opens, so a key bound after listen still authenticates.
+ */
+export function resolveHostedPeerConnections(args) {
+    const base = trimTrailingSlash(args.peersUrl);
+    return args.refs.map((ref) => {
+        const url = `${base}/${peerDeploySlug(ref.targetSlug)}${MCP_ENDPOINT_PATH}`;
+        return {
+            name: ref.name,
+            localUrl: url,
+            cloudUrl: url,
+            headers: { authorization: "Bearer ${CURSOR_API_KEY}" },
+        };
+    });
+}
 function trimTrailingSlash(url) {
     return url.endsWith("/") ? url.slice(0, -1) : url;
 }

package/dist/internal/request-error-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-error-status.d.ts","sourceRoot":"","sources":["../../src/internal/request-error-status.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,2BAA2B,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CA8DpF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE"}
+{"version":3,"file":"request-error-status.d.ts","sourceRoot":"","sources":["../../src/internal/request-error-status.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,+BAA+B,CAAC;AAIvC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,2BAA2B,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAkEpF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE"}