@cursor/bdk 0.2.11 → 0.2.13

package/dist/internal/tool-call-retry.js

@@ -0,0 +1,387 @@
+/**
+ * Transient retry for a read-effect tool call that already executed.
+ *
+ * Writes, unclassified tools, dry-run stubs, approval denials, and
+ * validation failures never reach this helper. Auth, elicitation, and a
+ * timeout that already ran long enough to repeat are not transient.
+ *
+ * Backoff is full jitter (base 500ms, cap 4s) and at most 10s asleep per
+ * call. An attempt that already ran longer than 15s is not retried, so
+ * one slow call plus the backoff budget stays under 30s. Sleep yields the
+ * event loop, so a timer can still fire during the wait.
+ */
+import { metrics } from "@opentelemetry/api";
+/** Total tries, including the first, for a read-effect call. */
+export const TOOL_RETRY_DEFAULT_MAX_ATTEMPTS = 3;
+export const TOOL_RETRY_BACKOFF_BASE_MS = 500;
+export const TOOL_RETRY_BACKOFF_CAP_MS = 4_000;
+/** Cumulative sleep per call. */
+export const TOOL_RETRY_BACKOFF_BUDGET_MS = 10_000;
+/**
+ * An attempt slower than this is not retried. Paired with the backoff
+ * budget, the extra wait stays under 30s.
+ */
+export const TOOL_RETRY_MAX_ATTEMPT_MS = 15_000;
+/** Quiet-stream limit the extra wait must stay under. */
+export const TOOL_RETRY_STALL_FAIL_MS = 30_000;
+const METRIC_NAME = "agent_sdk.tool.retry";
+const TRANSIENT_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "EAI_AGAIN",
+    "EPIPE",
+    "ETIMEDOUT",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_SOCKET",
+    "UND_ERR_CLOSED",
+]);
+const TRANSIENT_HTTP_STATUS = new Set([429, 502, 503, 504]);
+const MAX_CAUSE_DEPTH = 8;
+const ENDPOINT_DEADLINE = /tool call timed out after \d+\s*ms/i;
+const TIMEOUT_WORD = /timed?\s*out|\btimeout\b/i;
+const OVERSIZE = /too large|\boversize\b|payload exceeds|result exceeds/i;
+const AUTH_TEXT = /needsauth|needs authorization|\belicitation\b|\bunauthorized\b/i;
+const TRANSPORT_TEXT = /econnreset|econnrefused|socket hang up|fetch failed|eai_again|und_err_connect|und_err_socket|connection closed/i;
+const HTTP_STATUS_TEXT = /\b(?:HTTP\s*)?(429|502|503|504)\b/i;
+const MCP_TRANSIENT_TEXT = /rate limit|temporarily unavailable|(?<!do not )try again/i;
+const RETRY_AFTER_TEXT = /retry-after[^\d]{0,16}(\d+(?:\.\d+)?)/i;
+/**
+ * Vendor-reported MCP `isError` result. Distinct from a thrown transport
+ * failure so the classifier can require an explicit transient phrase.
+ */
+export class McpToolError extends Error {
+    constructor(args) {
+        super(args.vendorMessage === ""
+            ? `${args.connection} tool ${args.toolName} failed`
+            : args.vendorMessage);
+        this.name = "McpToolError";
+        this.connection = args.connection;
+        this.toolName = args.toolName;
+        this.vendorMessage = args.vendorMessage;
+    }
+}
+let sleepImpl = defaultSleep;
+let randomImpl = Math.random;
+let meterOverride;
+let counterCache;
+/** @internal Test seam. `undefined` restores the real timer. */
+export function setToolRetrySleepForTests(sleep) {
+    sleepImpl = sleep ?? defaultSleep;
+}
+/** @internal Test seam. `undefined` restores `Math.random`. */
+export function setToolRetryRandomForTests(random) {
+    randomImpl = random ?? Math.random;
+}
+/** @internal Test seam. `undefined` restores the global meter. */
+export function setToolRetryMeterForTests(meter) {
+    meterOverride = meter;
+    counterCache = undefined;
+}
+export function classifyToolFailure(error) {
+    return classifyAtDepth(error, 0);
+}
+/**
+ * Full-jitter delay for the backoff after `failedAttempt` (1 = first try
+ * failed). `Retry-After` replaces the jittered delay and is still capped.
+ * Returns `undefined` when the cumulative budget is already spent.
+ */
+export function toolRetryBackoffMs(args) {
+    const remaining = TOOL_RETRY_BACKOFF_BUDGET_MS - args.spentMs;
+    if (remaining <= 0) {
+        return undefined;
+    }
+    const unit = Math.min(Math.max(args.random, 0), 1);
+    const exp = TOOL_RETRY_BACKOFF_BASE_MS * 2 ** Math.max(0, args.failedAttempt - 1);
+    const jittered = unit * Math.min(TOOL_RETRY_BACKOFF_CAP_MS, exp);
+    const chosen = args.retryAfterMs !== undefined && Number.isFinite(args.retryAfterMs) && args.retryAfterMs >= 0
+        ? args.retryAfterMs
+        : jittered;
+    return Math.min(chosen, TOOL_RETRY_BACKOFF_CAP_MS, remaining);
+}
+export async function retryReadOnlyToolCall(args) {
+    const maxAttempts = TOOL_RETRY_DEFAULT_MAX_ATTEMPTS;
+    const eligible = args.effect === "read";
+    if (!eligible) {
+        try {
+            return await args.execute();
+        }
+        catch (error) {
+            if (classifyToolFailure(error).transient) {
+                recordOutcome("not_eligible");
+            }
+            throw error;
+        }
+    }
+    const now = args.now ?? Date.now;
+    let spentMs = 0;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        throwIfAborted(args.signal);
+        const started = now();
+        try {
+            const result = await args.execute();
+            if (attempt > 1) {
+                recordOutcome("recovered");
+            }
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            if (args.signal?.aborted === true) {
+                throw abortError(args.signal);
+            }
+            const elapsed = now() - started;
+            const verdict = classifyToolFailure(error);
+            const slow = elapsed > TOOL_RETRY_MAX_ATTEMPT_MS;
+            const canRetry = verdict.transient && !slow && attempt < maxAttempts;
+            if (!canRetry) {
+                if (verdict.transient && (slow || attempt >= maxAttempts)) {
+                    recordOutcome(attempt > 1 ? "exhausted" : "not_eligible");
+                }
+                else if (attempt > 1) {
+                    recordOutcome("exhausted");
+                }
+                if (attempt > 1) {
+                    throw exhaustedError(attempt, error);
+                }
+                throw error;
+            }
+            const delay = toolRetryBackoffMs({
+                failedAttempt: attempt,
+                random: randomImpl(),
+                retryAfterMs: verdict.retryAfterMs,
+                spentMs,
+            });
+            if (delay === undefined) {
+                recordOutcome("exhausted");
+                throw exhaustedError(attempt, error);
+            }
+            const notice = {
+                attempt: attempt + 1,
+                reason: verdict.reason,
+                backoffMs: delay,
+                ...(args.connection === undefined ? {} : { connection: args.connection }),
+            };
+            args.onRetry?.(notice);
+            await sleepImpl(delay, args.signal);
+            spentMs += delay;
+            throwIfAborted(args.signal);
+        }
+    }
+    recordOutcome("exhausted");
+    throw exhaustedError(maxAttempts, lastError);
+}
+function recordOutcome(outcome) {
+    const counter = retryCounter();
+    counter?.add(1, { outcome });
+}
+function retryCounter() {
+    if (counterCache !== undefined) {
+        return counterCache;
+    }
+    const meter = meterOverride ?? metrics.getMeter("@cursor/bdk");
+    counterCache = meter.createCounter(METRIC_NAME, {
+        description: "Read-only tool retries by outcome",
+    });
+    return counterCache;
+}
+function exhaustedError(attempts, error) {
+    const detail = error instanceof Error && error.message !== "" ? error.message : "unknown error";
+    const wrapped = new Error(`failed after ${attempts} attempts: ${detail}`);
+    wrapped.cause = error;
+    return wrapped;
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted === true) {
+        throw abortError(signal);
+    }
+}
+function abortError(signal) {
+    const reason = signal?.reason;
+    if (reason instanceof Error) {
+        return reason;
+    }
+    const error = new Error("The turn was aborted.");
+    error.name = "AbortError";
+    return error;
+}
+function defaultSleep(ms, signal) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortError(signal));
+        };
+        if (signal?.aborted === true) {
+            clearTimeout(timer);
+            reject(abortError(signal));
+            return;
+        }
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function classifyAtDepth(error, depth) {
+    if (depth >= MAX_CAUSE_DEPTH || !(error instanceof Error)) {
+        return { transient: false };
+    }
+    if (isVeto(error)) {
+        return { transient: false };
+    }
+    const status = httpStatus(error);
+    if (status !== undefined && status >= 400 && status <= 499 && status !== 429) {
+        return { transient: false };
+    }
+    const retryAfterMs = readRetryAfterMs(error);
+    if (status !== undefined && TRANSIENT_HTTP_STATUS.has(status)) {
+        return { transient: true, reason: httpReason(status), retryAfterMs };
+    }
+    const code = errorCode(error);
+    if (code !== undefined && TRANSIENT_CODES.has(code)) {
+        return { transient: true, reason: "transport", retryAfterMs };
+    }
+    if (code !== undefined && code.startsWith("UND_ERR_") && /CONNECT|SOCKET/.test(code)) {
+        return { transient: true, reason: "transport", retryAfterMs };
+    }
+    // A vendor isError string is not a transport failure. Only the MCP
+    // allowlist retries it.
+    if (error instanceof McpToolError) {
+        const vendor = classifyMcpVendorMessage(error.vendorMessage, retryAfterMs);
+        if (vendor !== undefined) {
+            return vendor;
+        }
+        return classifyAtDepth(error.cause, depth + 1);
+    }
+    if (TRANSPORT_TEXT.test(error.message)) {
+        return { transient: true, reason: "transport", retryAfterMs };
+    }
+    const fromText = error.message.match(HTTP_STATUS_TEXT);
+    if (fromText !== null) {
+        const parsed = Number(fromText[1]);
+        if (TRANSIENT_HTTP_STATUS.has(parsed)) {
+            return { transient: true, reason: httpReason(parsed), retryAfterMs };
+        }
+    }
+    if (error instanceof AggregateError) {
+        for (const inner of error.errors) {
+            const verdict = classifyAtDepth(inner, depth + 1);
+            if (verdict.transient) {
+                return verdict;
+            }
+        }
+    }
+    return classifyAtDepth(error.cause, depth + 1);
+}
+function classifyMcpVendorMessage(vendorMessage, retryAfterMs) {
+    if (MCP_TRANSIENT_TEXT.test(vendorMessage)) {
+        return { transient: true, reason: "mcp_transient", retryAfterMs };
+    }
+    const fromText = vendorMessage.match(HTTP_STATUS_TEXT);
+    if (fromText !== null) {
+        const parsed = Number(fromText[1]);
+        if (TRANSIENT_HTTP_STATUS.has(parsed)) {
+            return { transient: true, reason: httpReason(parsed), retryAfterMs };
+        }
+    }
+    return undefined;
+}
+function isVeto(error) {
+    if (error.name === "McpNeedsAuthError" || error.name === "UnauthorizedError") {
+        return true;
+    }
+    const text = `${error.name}\n${error.message}`;
+    if (AUTH_TEXT.test(text) || OVERSIZE.test(text) || ENDPOINT_DEADLINE.test(text)) {
+        return true;
+    }
+    const status = httpStatus(error);
+    if (status === 401 || status === 403 || status === 413) {
+        return true;
+    }
+    return timeoutLongerThanAttemptCap(text);
+}
+function timeoutLongerThanAttemptCap(text) {
+    if (!TIMEOUT_WORD.test(text)) {
+        return false;
+    }
+    for (const match of text.matchAll(/(\d+)\s*ms\b/gi)) {
+        if (Number(match[1]) > TOOL_RETRY_MAX_ATTEMPT_MS) {
+            return true;
+        }
+    }
+    for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(?:seconds|\bsec\b|\bs\b)/gi)) {
+        if (Number(match[1]) * 1000 > TOOL_RETRY_MAX_ATTEMPT_MS) {
+            return true;
+        }
+    }
+    return false;
+}
+function httpReason(status) {
+    switch (status) {
+        case 429:
+            return "http_429";
+        case 502:
+            return "http_502";
+        case 504:
+            return "http_504";
+        default:
+            return "http_503";
+    }
+}
+function httpStatus(error) {
+    const record = error;
+    for (const value of [record.status, record.statusCode]) {
+        if (typeof value === "number" && Number.isInteger(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function errorCode(error) {
+    const code = error.code;
+    return typeof code === "string" && code.length > 0 ? code : undefined;
+}
+function readRetryAfterMs(error) {
+    const record = error;
+    const header = record.headers?.get?.("retry-after") ?? record.headers?.get?.("Retry-After");
+    const fromHeader = parseRetryAfter(header);
+    if (fromHeader !== undefined) {
+        return fromHeader;
+    }
+    if (typeof record.retryAfter === "number" && Number.isFinite(record.retryAfter)) {
+        return record.retryAfter * 1000;
+    }
+    if (typeof record.retryAfter === "string") {
+        const parsed = parseRetryAfter(record.retryAfter);
+        if (parsed !== undefined) {
+            return parsed;
+        }
+    }
+    const match = error.message.match(RETRY_AFTER_TEXT);
+    if (match !== null) {
+        return Number(match[1]) * 1000;
+    }
+    return undefined;
+}
+function parseRetryAfter(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+        return undefined;
+    }
+    const seconds = Number(trimmed);
+    if (Number.isFinite(seconds)) {
+        return Math.max(0, seconds * 1000);
+    }
+    const date = Date.parse(trimmed);
+    if (Number.isNaN(date)) {
+        return undefined;
+    }
+    return Math.max(0, date - Date.now());
+}

package/dist/internal/tool-result.js

@@ -38,8 +38,8 @@ export function toolCallErrorMessage(result) {
         return undefined;
     }
     const texts = result.content
-        .filter(part => part.type === "text" && typeof part.text === "string")
-        .map(part => part.text.trim())
-        .filter(text => text !== "");
+        .filter((part) => part.type === "text" && typeof part.text === "string")
+        .map((part) => part.text.trim())
+        .filter((text) => text !== "");
     return texts.length === 0 ? undefined : texts.join("\n");
 }

package/dist/internal/trajectory.js

@@ -93,7 +93,7 @@ export function buildTrajectory(events) {
                     };
                     pendingCalls.set(call.callId, entry);
                     if (parentCallId !== undefined) {
-                        let sub = turn.subagents.find(s => s.callId === parentCallId);
+                        let sub = turn.subagents.find((s) => s.callId === parentCallId);
                         if (sub === undefined) {
                             sub = { callId: parentCallId, toolCalls: [] };
                             turn.subagents.push(sub);
@@ -144,7 +144,7 @@ export function buildTrajectory(events) {
                         parentCallId: event.data.parentCallId,
                     };
                     if (event.data.parentCallId !== undefined) {
-                        let sub = turn.subagents.find(s => s.callId === event.data.parentCallId);
+                        let sub = turn.subagents.find((s) => s.callId === event.data.parentCallId);
                         if (sub === undefined) {
                             sub = {
                                 callId: event.data.parentCallId,
@@ -163,7 +163,7 @@ export function buildTrajectory(events) {
             case "subagent.called": {
                 if (event.turnId !== undefined) {
                     const turn = ensureTurn(event.turnId);
-                    const existing = turn.subagents.find(s => s.callId === event.data.callId);
+                    const existing = turn.subagents.find((s) => s.callId === event.data.callId);
                     if (existing !== undefined) {
                         existing.name = event.data.name;
                         existing.description = event.data.description;
@@ -219,11 +219,11 @@ export function buildTrajectory(events) {
                 break;
         }
     }
-    const turns = turnOrder.map(id => turnsById.get(id));
-    const turnsFailed = turns.filter(t => t.failed).length;
+    const turns = turnOrder.map((id) => turnsById.get(id));
+    const turnsFailed = turns.filter((t) => t.failed).length;
     const toolCallCount = turns.reduce((n, t) => n + t.toolCalls.length + t.subagents.reduce((m, s) => m + s.toolCalls.length, 0), 0);
-    const lastGood = [...turns].reverse().find(t => t.assistantText !== "");
-    const costedTurns = turns.filter(t => t.cost !== undefined);
+    const lastGood = [...turns].reverse().find((t) => t.assistantText !== "");
+    const costedTurns = turns.filter((t) => t.cost !== undefined);
     const totalCostUsd = costedTurns.length === 0
         ? undefined
         : roundCostUsd(costedTurns.reduce((sum, t) => sum + (t.cost?.totalUsd ?? 0), 0));

package/dist/internal/turn-governor.js

@@ -51,10 +51,10 @@ export class TurnGovernor {
         if (args.signal?.aborted === true) {
             return Promise.resolve(undefined);
         }
-        return new Promise(resolve => {
+        return new Promise((resolve) => {
             const waiter = {
                 sessionId: args.sessionId,
-                grant: permit => resolve(permit),
+                grant: (permit) => resolve(permit),
                 cancel: () => resolve(undefined),
                 cleanup: () => {
                     this.queuedSessions.delete(args.sessionId);

package/dist/internal/turn-outbox.js

@@ -46,7 +46,7 @@ export class TurnOutbox {
             return [];
         }
         const items = [];
-        for (const name of names.filter(n => n.endsWith(".json")).sort()) {
+        for (const name of names.filter((n) => n.endsWith(".json")).sort()) {
             const path = join(dir, name);
             try {
                 const raw = await readFile(path, "utf8");

package/dist/internal/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/internal/update-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/internal/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0C5D;AAQD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB9B;AAMD,QAAA,MAAM,WAAW,EAAE,CAAC,CAAC,SAAS,CAC5B;IAAE,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,EACrE,OAAO,CAMP,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAsB,oBAAoB,CACxC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAavC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,gBAAgB,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAMD,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,wCAAwC;IACxC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCnF;AAUD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA8DrC;AA4ED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4D3E"}

package/dist/internal/update-check.js

@@ -276,7 +276,9 @@ async function findDependingProjectDir(packageRoot, packageName) {
         if (parent === dir) {
             return undefined;
         }
-        const inNodeModules = dir.split(sep).some(part => part === "node_modules" || part === ".pnpm");
+        const inNodeModules = dir
+            .split(sep)
+            .some((part) => part === "node_modules" || part === ".pnpm");
         if (!inNodeModules && (await declaresDependency(dir, packageName))) {
             return dir;
         }
@@ -392,7 +394,7 @@ function runUpdateCommand(command) {
             shell: process.platform === "win32",
         });
         child.on("error", reject);
-        child.on("close", code => {
+        child.on("close", (code) => {
             resolve(code ?? 1);
         });
     });

package/dist/internal/v2-hosting.d.ts

@@ -14,7 +14,13 @@ export type AgentV2Hosting = {
     resolveStoreIds: () => CursorManagedV2StoreIds;
 } | {
     kind: "cursor-managed-persistent";
+    resolveStoreIds: () => CursorManagedV2StoreIds;
 };
+/** Hosting whose framework session state is mirrored to the platform stores. */
+export type CursorManagedV2Hosting = Extract<AgentV2Hosting, {
+    resolveStoreIds: () => CursorManagedV2StoreIds;
+}>;
+export declare function isCursorManagedV2Hosting(hosting: AgentV2Hosting): hosting is CursorManagedV2Hosting;
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *

package/dist/internal/v2-hosting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAEvE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;CACnC,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAejB"}
+{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAEvE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,CAAC;AAEN,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,cAAc,EACd;IAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;CAAE,CACnD,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,sBAAsB,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAkBjB"}

package/dist/internal/v2-hosting.js

@@ -5,6 +5,9 @@ import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
  * runtime the host provides a durable state directory.
  */
 export const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
+export function isCursorManagedV2Hosting(hosting) {
+    return hosting.kind === "cursor-managed" || hosting.kind === "cursor-managed-persistent";
+}
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *
@@ -20,7 +23,10 @@ export function resolveAgentV2Hosting(input) {
         return { kind: "self-hosted" };
     }
     if (env[AGENT_SERVE_PERSISTENT_ENV_VAR] === "1") {
-        return { kind: "cursor-managed-persistent" };
+        return {
+            kind: "cursor-managed-persistent",
+            resolveStoreIds: () => requireCursorManagedV2StoreIdsSync(env),
+        };
     }
     return {
         kind: "cursor-managed",

package/dist/internal/workspace.js

@@ -47,7 +47,7 @@ export function buildCloudWorkspaceSection(dir) {
  * path is replaced on each send and removed when a task session ends.
  */
 export function buildCloudSessionWorkspaceSection(dir, relPaths) {
-    const listed = relPaths.map(path => `\`${path}\``).join(", ");
+    const listed = relPaths.map((path) => `\`${path}\``).join(", ");
     return [
         "## Session workspace files",
         "",
@@ -102,7 +102,7 @@ export function withIdentityPreamble(name, instructions) {
  *   Local workspaces omit bodies because the files already exist on disk.
  */
 export function buildAgentToolsCatalog(tools, options = { includeScripts: false }) {
-    const agentTools = tools.filter(tool => tool.execution === "agent");
+    const agentTools = tools.filter((tool) => tool.execution === "agent");
     if (agentTools.length === 0) {
         return "";
     }
@@ -156,7 +156,7 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
  * a host tool and the host-side marker never appears.
  */
 export function buildServerToolsCatalog(tools, options) {
-    const serverTools = tools.filter(tool => tool.execution === "server");
+    const serverTools = tools.filter((tool) => tool.execution === "server");
     if (serverTools.length === 0) {
         return "";
     }
@@ -210,7 +210,7 @@ export function buildAgentsMdContent(agent, options) {
             includeScripts: options.includeScripts,
         }),
     ]
-        .filter(part => part !== "")
+        .filter((part) => part !== "")
         .join("\n\n");
 }
 /**

package/dist/kv/memory-kv.js

@@ -58,7 +58,7 @@ export function createMemoryKv() {
             return { ok: true, version };
         },
         async listKeys(prefix) {
-            return [...entries.keys()].filter(key => key.startsWith(prefix)).sort();
+            return [...entries.keys()].filter((key) => key.startsWith(prefix)).sort();
         },
     };
 }
@@ -72,9 +72,9 @@ export function createMemoryKv() {
 export function memoryCasTable() {
     const kv = createMemoryKv();
     return {
-        getWithVersion: key => kv.getWithVersion(key),
+        getWithVersion: (key) => kv.getWithVersion(key),
         putIfAbsent: (key, value) => kv.putIfAbsent(key, value),
         putIfVersion: (key, value, expectedVersion) => kv.putIfVersion(key, value, expectedVersion),
-        listKeys: prefix => kv.listKeys(prefix),
+        listKeys: (prefix) => kv.listKeys(prefix),
     };
 }