@cursor/bdk 0.2.10 → 0.2.12

package/dist/internal/local-env.js

@@ -25,7 +25,7 @@ export function loadAgentLocalEnv(dir) {
         loaded.push(path);
     };
     const trackLoadedKeys = () => {
-        fileLoadedKeys = new Set(Object.keys(process.env).filter(key => !realKeys.has(key)));
+        fileLoadedKeys = new Set(Object.keys(process.env).filter((key) => !realKeys.has(key)));
     };
     const tryLoadDir = (agentDir) => {
         // `.env.local` first so its values win over checked-in `.env` defaults
@@ -37,8 +37,8 @@ export function loadAgentLocalEnv(dir) {
     let children;
     try {
         children = readdirSync(dir, { withFileTypes: true })
-            .filter(entry => entry.isDirectory() && !entry.name.startsWith("."))
-            .map(entry => entry.name);
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith("."))
+            .map((entry) => entry.name);
     }
     catch {
         trackLoadedKeys();

package/dist/internal/log-ring.js

@@ -25,7 +25,7 @@ export function createLogRing(options = {}) {
             if (entries.length === 0) {
                 return [];
             }
-            const start = entries.findIndex(e => e.index > after);
+            const start = entries.findIndex((e) => e.index > after);
             if (start < 0) {
                 return [];
             }

package/dist/internal/logs-client.js

@@ -404,7 +404,7 @@ async function sleepMs(ms, signal) {
     if (isAborted(signal)) {
         return;
     }
-    await new Promise(resolve => {
+    await new Promise((resolve) => {
         const timer = setTimeout(() => {
             signal?.removeEventListener("abort", onAbort);
             resolve();

package/dist/internal/mcp-endpoint.js

@@ -90,7 +90,7 @@ export async function handleStatelessMcpRequest(args) {
 /** Tool names the MCP surface exposes for `project` (info projection). */
 export function mcpEndpointToolNames(project) {
     const names = ["ask", "check"];
-    if (project.agent.tools.some(tool => tool.execution === "server")) {
+    if (project.agent.tools.some((tool) => tool.execution === "server")) {
         names.push("call_tool");
     }
     return names;
@@ -137,9 +137,9 @@ function buildToolMcpServer(engine, sessionId) {
         capabilities: { tools: {} },
         instructions: "Direct tools implemented by the AgentSDK deployment for its active cloud turn.",
     });
-    const tools = engine.project.agent.tools.filter(tool => tool.execution === "server");
+    const tools = engine.project.agent.tools.filter((tool) => tool.execution === "server");
     server.setRequestHandler(ListToolsRequestSchema, () => Promise.resolve({
-        tools: tools.map(tool => ({
+        tools: tools.map((tool) => ({
             name: tool.name,
             description: tool.description,
             inputSchema: tool.inputSchema,
@@ -150,7 +150,7 @@ function buildToolMcpServer(engine, sessionId) {
         if (sessionId === null || sessionId === "") {
             return errorResult("Missing AgentSDK session binding.");
         }
-        const tool = tools.find(candidate => candidate.name === request.params.name);
+        const tool = tools.find((candidate) => candidate.name === request.params.name);
         if (tool === undefined) {
             return errorResult(`Unknown server tool "${request.params.name}".`);
         }
@@ -203,7 +203,7 @@ function buildConnectionBridgeMcpServer(engine, sessionId, connectionName) {
         }
         const tools = await engine.runWithMcpPark(sessionId ?? "", "tools/list", () => engine.host.mcp.listTools(connectionName));
         return {
-            tools: tools.map(tool => ({
+            tools: tools.map((tool) => ({
                 name: tool.name,
                 ...(tool.description === undefined ? {} : { description: tool.description }),
                 inputSchema: tool.inputSchema ?? { type: "object" },
@@ -303,11 +303,11 @@ function buildAgentMcpServer(engine, auth) {
             return errorResult(describeError(error));
         }
     });
-    const serverTools = agent.tools.filter(tool => tool.execution === "server");
+    const serverTools = agent.tools.filter((tool) => tool.execution === "server");
     if (serverTools.length > 0) {
         server.registerTool("call_tool", {
             description: `Call one of this agent's deterministic server tools directly (no model turn decides anything). Available tools: ${serverTools
-                .map(tool => tool.name)
+                .map((tool) => tool.name)
                 .join(", ")}.`,
             inputSchema: {
                 toolName: z.string().describe("Name of the server tool to call."),
@@ -543,7 +543,7 @@ function raceTimeout(promise, ms) {
         const timer = setTimeout(() => {
             resolve(undefined);
         }, ms);
-        promise.then(value => {
+        promise.then((value) => {
             clearTimeout(timer);
             resolve(value);
         }, (error) => {

package/dist/internal/mcp-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-host.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AASrB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAS9C;CACF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAMvE;AAoBD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxF;AAED,qBAAa,OAAQ,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,YAAY,WAAW,EAAE,oBAAoB,EAAE,EAI9C;IAED,gFAAgF;IAChF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEpD;IAED,KAAK,IAAI,MAAM,EAAE,CAEhB;IAEK,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAUlE;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,GAAG,aAAa,CAwCtD;IAEK,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAa5B;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAED;;;;;;;;OAQG;YACW,UAAU;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;YAwBH,gBAAgB;IAc9B,OAAO,CAAC,iBAAiB;YASX,OAAO;CAGtB;AASD,+BAA+B;AAC/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAqB3F"}
+{"version":3,"file":"mcp-host.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AASrB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAS9C;CACF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAMvE;AAoBD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxF;AAED,qBAAa,OAAQ,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,YAAY,WAAW,EAAE,oBAAoB,EAAE,EAI9C;IAED,gFAAgF;IAChF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEpD;IAED,KAAK,IAAI,MAAM,EAAE,CAEhB;IAEK,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAUlE;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,GAAG,aAAa,CAwCtD;IAEK,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAa5B;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED;;;;;;;;OAQG;YACW,UAAU;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;YAwBH,gBAAgB;IAc9B,OAAO,CAAC,iBAAiB;YASX,OAAO;CAGtB;AASD,+BAA+B;AAC/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAqB3F"}

package/dist/internal/mcp-host.js

@@ -36,7 +36,7 @@ export function hostMcpCallNeedsAuth(result) {
     if (result.isError !== true) {
         return false;
     }
-    const text = result.content.map(part => (part.type === "text" ? part.text : "")).join("\n");
+    const text = result.content.map((part) => (part.type === "text" ? part.text : "")).join("\n");
     return text.includes("needsAuth") || text.includes("needs authorization");
 }
 function throwIfCallNeedsAuth(connection, result) {
@@ -73,7 +73,7 @@ export class McpHost {
             const listed = await client.listTools(mcpListParams());
             return listed.tools
                 .map(toToolInfo)
-                .filter(tool => connectionAllowsTool(connection, tool.name));
+                .filter((tool) => connectionAllowsTool(connection, tool.name));
         }));
     }
     /**
@@ -101,7 +101,7 @@ export class McpHost {
                 const listed = await client.listTools(mcpListParams());
                 return listed.tools
                     .map(toToolInfo)
-                    .filter(tool => connectionAllowsTool(connection, tool.name));
+                    .filter((tool) => connectionAllowsTool(connection, tool.name));
             })),
             callTool: (toolName, args = {}) => {
                 assertConnectionAllowsTool(connection, toolName);
@@ -146,7 +146,7 @@ export class McpHost {
         }
     }
     async close() {
-        const opened = await Promise.allSettled([...this.clients.values()].map(entry => entry.opened));
+        const opened = await Promise.allSettled([...this.clients.values()].map((entry) => entry.opened));
         this.clients.clear();
         await Promise.allSettled(opened.map(async (settled) => {
             if (settled.status === "fulfilled") {
@@ -196,7 +196,7 @@ export class McpHost {
         // replaced would otherwise orphan the client that replaced it.
         const entry = {
             credentials,
-            opened: this.connect(name).catch(error => {
+            opened: this.connect(name).catch((error) => {
                 if (this.clients.get(name) === entry) {
                     this.clients.delete(name);
                 }

package/dist/internal/mcp-oauth-on-demand.js

@@ -27,7 +27,7 @@ export async function beginHostMcpOauth(args) {
         resourceUrl: args.url,
         store: args.store,
         redirectUrl: args.redirectUrl,
-        onRedirect: url => {
+        onRedirect: (url) => {
             authorizationUrl = url;
         },
     });
@@ -109,10 +109,10 @@ export class McpOauthOnDemandHub {
         return { authUrl: started.authUrl, state: started.state };
     }
     async abortCall(sessionId, callId) {
-        await this.dropWhere(attempt => attempt.sessionId === sessionId && attempt.callId === callId, true);
+        await this.dropWhere((attempt) => attempt.sessionId === sessionId && attempt.callId === callId, true);
     }
     async abortSession(sessionId) {
-        await this.dropWhere(attempt => attempt.sessionId === sessionId, false);
+        await this.dropWhere((attempt) => attempt.sessionId === sessionId, false);
     }
     async close() {
         await this.dropWhere(() => true, true);

package/dist/internal/mcp-oauth.js

@@ -83,12 +83,12 @@ export class FileMcpOAuthStore {
         return (await this.entryFor(id, resourceUrl))?.clientInfo;
     }
     async saveTokens(id, resourceUrl, tokens) {
-        await this.update(id, resourceUrl, entry => {
+        await this.update(id, resourceUrl, (entry) => {
             entry.tokens = tokens;
         });
     }
     async saveClientInformation(id, resourceUrl, clientInfo) {
-        await this.update(id, resourceUrl, entry => {
+        await this.update(id, resourceUrl, (entry) => {
             entry.clientInfo = clientInfo;
         });
     }
@@ -126,7 +126,7 @@ export class FileMcpOAuthStore {
         if (this.cache !== undefined) {
             return this.cache;
         }
-        this.loading ??= this.readDisk().then(data => {
+        this.loading ??= this.readDisk().then((data) => {
             this.cache = data;
             return data;
         });
@@ -161,7 +161,7 @@ export class FileMcpOAuthStore {
     async withLock(fn) {
         const prev = locks.get(this.path) ?? Promise.resolve();
         let release;
-        locks.set(this.path, new Promise(resolve => {
+        locks.set(this.path, new Promise((resolve) => {
             release = resolve;
         }));
         try {
@@ -368,7 +368,7 @@ export async function waitForMcpOAuthCallback(args) {
         const timer = setTimeout(() => {
             finish(undefined, new Error(`Timed out waiting for OAuth callback on http://localhost:${port}${path}`));
         }, timeoutMs);
-        server.on("error", error => {
+        server.on("error", (error) => {
             finish(undefined, new Error(`OAuth callback port ${port} failed: ${error instanceof Error ? error.message : String(error)}`));
         });
         server.listen(port, "127.0.0.1");

package/dist/internal/net.js

@@ -20,8 +20,8 @@ export function isLoopbackHostname(hostname) {
     if (ipv4 === null) {
         return false;
     }
-    const octets = ipv4.slice(1, 5).map(part => Number(part));
-    if (octets.some(octet => octet > 255)) {
+    const octets = ipv4.slice(1, 5).map((part) => Number(part));
+    if (octets.some((octet) => octet > 255)) {
         return false;
     }
     return octets[0] === 127;

package/dist/internal/otel/config.js

@@ -49,7 +49,7 @@ export function resolveOtelConfig(input) {
     };
     const envExporters = exportersFromEnv(env);
     const exporters = merged.exporters !== undefined && merged.exporters.length > 0
-        ? merged.exporters.map(e => withEnvHeaders(e, env))
+        ? merged.exporters.map((e) => withEnvHeaders(e, env))
         : envExporters;
     const optedIn = input.authored !== undefined || input.serve !== undefined || envExporters.length > 0;
     if (!optedIn) {
@@ -96,7 +96,7 @@ export function stripSignalPath(url) {
 }
 /** Exporters that apply to one signal (honors per-exporter `signals`). */
 export function exportersForSignal(exporters, signal) {
-    return exporters.filter(exporter => exporter.signals === undefined || exporter.signals.includes(signal));
+    return exporters.filter((exporter) => exporter.signals === undefined || exporter.signals.includes(signal));
 }
 function disabled() {
     return {
@@ -210,7 +210,7 @@ function stable(value) {
     const obj = value;
     return `{${Object.keys(obj)
         .sort()
-        .map(key => `${JSON.stringify(key)}:${stable(obj[key])}`)
+        .map((key) => `${JSON.stringify(key)}:${stable(obj[key])}`)
         .join(",")}}`;
 }
 function nonEmpty(value) {

package/dist/internal/otel/runtime.js

@@ -75,7 +75,7 @@ export async function shutdownOtelRuntime(runtime) {
 }
 export async function raceOtelForceFlush(work, log, timeoutMs = OTEL_FORCE_FLUSH_TIMEOUT_MS) {
     let timer;
-    const timeout = new Promise(resolve => {
+    const timeout = new Promise((resolve) => {
         timer = setTimeout(() => resolve("timeout"), timeoutMs);
     });
     const result = await Promise.race([
@@ -91,11 +91,11 @@ export async function raceOtelForceFlush(work, log, timeoutMs = OTEL_FORCE_FLUSH
 }
 function startOtelSdk(config, logger, resolveExport) {
     diag.setLogger({
-        verbose: m => logger(`[bdk:otel] ${m}`),
-        debug: m => logger(`[bdk:otel] ${m}`),
-        info: m => logger(`[bdk:otel] ${m}`),
-        warn: m => logger(`[bdk:otel] warn: ${m}`),
-        error: m => logger(`[bdk:otel] error: ${m}`),
+        verbose: (m) => logger(`[bdk:otel] ${m}`),
+        debug: (m) => logger(`[bdk:otel] ${m}`),
+        info: (m) => logger(`[bdk:otel] ${m}`),
+        warn: (m) => logger(`[bdk:otel] warn: ${m}`),
+        error: (m) => logger(`[bdk:otel] error: ${m}`),
     }, DiagLogLevel.ERROR);
     const resource = buildResource(config);
     let tracerProvider;
@@ -136,7 +136,7 @@ function startOtelSdk(config, logger, resolveExport) {
             const exportIntervalMillis = metricOpts.exportIntervalMillis ?? 10_000;
             const provider = new MeterProvider({
                 resource,
-                readers: exporters.map(exporter => new PeriodicExportingMetricReader({
+                readers: exporters.map((exporter) => new PeriodicExportingMetricReader({
                     exporter: createMetricExporter(exporter, signalUrl(exporter.url, "metrics")),
                     exportIntervalMillis,
                 })),
@@ -155,7 +155,7 @@ function startOtelSdk(config, logger, resolveExport) {
         if (exporters.length > 0) {
             const provider = new LoggerProvider({
                 resource,
-                processors: exporters.map(exporter => new BatchLogRecordProcessor(createLogExporter(exporter, signalUrl(exporter.url, "logs")))),
+                processors: exporters.map((exporter) => new BatchLogRecordProcessor(createLogExporter(exporter, signalUrl(exporter.url, "logs")))),
             });
             // api-logs returns the active provider (ours on success, existing otherwise).
             if (logs.setGlobalLoggerProvider(provider) === provider) {
@@ -226,22 +226,22 @@ function withExportResource(span, resource) {
     });
 }
 async function exportQueuedSpans(spans, destinations, logger, resource) {
-    const payload = spans.map(span => withExportResource(span, resource));
-    const exporters = destinations.map(destination => createTraceExporter(destination, signalUrl(destination.url, "traces")));
+    const payload = spans.map((span) => withExportResource(span, resource));
+    const exporters = destinations.map((destination) => createTraceExporter(destination, signalUrl(destination.url, "traces")));
     try {
-        const results = await Promise.all(exporters.map(exporter => new Promise(resolve => {
+        const results = await Promise.all(exporters.map((exporter) => new Promise((resolve) => {
             exporter.export(payload, (result) => {
                 resolve(result.code === ExportResultCode.SUCCESS);
             });
         })));
-        return results.every(ok => ok);
+        return results.every((ok) => ok);
     }
     catch (error) {
         logger(`[bdk:otel] deferred export failed: ${error instanceof Error ? error.message : String(error)}`);
         return false;
     }
     finally {
-        await Promise.allSettled(exporters.map(exporter => exporter.shutdown()));
+        await Promise.allSettled(exporters.map((exporter) => exporter.shutdown()));
     }
 }
 function buildResource(config) {

package/dist/internal/peer-connections.js

@@ -18,7 +18,7 @@ import { MCP_ENDPOINT_PATH } from "./mcp-endpoint.js";
  * self-references (an agent asking itself recurses forever).
  */
 export function collectPeerConnections(mounts) {
-    const knownSlugs = new Set(mounts.map(({ slug }) => slug).filter(slug => slug !== ""));
+    const knownSlugs = new Set(mounts.map(({ slug }) => slug).filter((slug) => slug !== ""));
     const bySlug = new Map();
     for (const { slug, project } of mounts) {
         const refs = [];
@@ -57,7 +57,7 @@ export function resolvePeerConnections(args) {
     const serverBase = trimTrailingSlash(args.serverUrl);
     const publicBase = args.publicUrl === undefined ? undefined : trimTrailingSlash(args.publicUrl);
     const headers = args.authToken === undefined ? undefined : { authorization: `Bearer ${args.authToken}` };
-    return args.refs.map(ref => ({
+    return args.refs.map((ref) => ({
         name: ref.name,
         localUrl: `${serverBase}/${ref.targetSlug}${MCP_ENDPOINT_PATH}`,
         ...(publicBase === undefined

package/dist/internal/persistent-stage-log-mirror.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Mirror a persistent slot's `/state/logs` directory onto the framework store.
+ *
+ * One loop for every file in the folder. A file whose size and mtime match
+ * the last upload is left alone, including the read. Anything else is read
+ * from its tail, masked, and written over the same key. Store keys whose
+ * files are gone are deleted. The timer lives on the serve process, because
+ * a persistent VM stays up between turns. Freeze pods do not enter this path.
+ */
+import type { FileSink } from "../files.js";
+import type { AgentProject } from "../types.js";
+/** How often the resident process snapshots the directory. */
+export declare const PERSISTENT_STAGE_LOG_SYNC_INTERVAL_MS = 30000;
+/**
+ * Basenames written by the persistent stage logger: timestamp, optional generation, stage.
+ * Rejects paths, so a listing cannot escape the directory.
+ */
+export declare const PERSISTENT_STAGE_LOG_FILE_NAME: RegExp;
+export interface PersistentStageLogMirror {
+    logsDir: string;
+    sink: FileSink;
+    agentName: string;
+    logger: (line: string) => void;
+}
+export declare function selectPersistentStageLogMirror(input: {
+    project: AgentProject;
+    logsDir: string;
+    logger?: (line: string) => void;
+    env?: Record<string, string | undefined>;
+}): PersistentStageLogMirror | undefined;
+/**
+ * Start the directory sync and return a stop that flushes once more. The
+ * interval does not keep the process alive on its own. A tick that lands
+ * while a sync is running is dropped; stop still runs one more after it.
+ */
+export declare function startPersistentStageLogMirror(mirror: PersistentStageLogMirror, options?: {
+    intervalMs?: number;
+}): {
+    stop: () => Promise<void>;
+};
+/**
+ * Upload changed files under `persistent-stage-logs/`, then drop keys for files that are
+ * no longer in the directory. A missing directory is a no-op, so a tick before
+ * the first stage command does not sweep a previous snapshot.
+ */
+export declare function syncPersistentStageLogDirectory(args: {
+    dir: string;
+    sink: FileSink;
+    agentName: string;
+    uploaded: Map<string, {
+        size: number;
+        mtimeMs: number;
+    }>;
+    maxBytes?: number;
+    logger?: (line: string) => void;
+}): Promise<void>;
+//# sourceMappingURL=persistent-stage-log-mirror.d.ts.map

package/dist/internal/persistent-stage-log-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-stage-log-mirror.d.ts","sourceRoot":"","sources":["../../src/internal/persistent-stage-log-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,8DAA8D;AAC9D,eAAO,MAAM,qCAAqC,QAAS,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAkD,CAAC;AAEhG,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,GAAG,wBAAwB,GAAG,SAAS,CAiBvC;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAgD/B;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFhB"}

package/dist/internal/persistent-stage-log-mirror.js

@@ -0,0 +1,231 @@
+/**
+ * Mirror a persistent slot's `/state/logs` directory onto the framework store.
+ *
+ * One loop for every file in the folder. A file whose size and mtime match
+ * the last upload is left alone, including the read. Anything else is read
+ * from its tail, masked, and written over the same key. Store keys whose
+ * files are gone are deleted. The timer lives on the serve process, because
+ * a persistent VM stays up between turns. Freeze pods do not enter this path.
+ */
+import { open, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
+import { agentSdkStorageKeys } from "../storage-protocol.js";
+import { resolveApiKeySync } from "./cursor/credentials.js";
+import { describeError } from "./describe-error.js";
+import { maskStartLogTokens, START_LOG_STORE_MAX_BYTES } from "./start-log-store.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
+/** How often the resident process snapshots the directory. */
+export const PERSISTENT_STAGE_LOG_SYNC_INTERVAL_MS = 30_000;
+/**
+ * Basenames written by the persistent stage logger: timestamp, optional generation, stage.
+ * Rejects paths, so a listing cannot escape the directory.
+ */
+export const PERSISTENT_STAGE_LOG_FILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,180}\.log$/;
+export function selectPersistentStageLogMirror(input) {
+    const hosting = resolveAgentV2Hosting({
+        architecture: input.project.agent.architecture,
+        env: input.env,
+    });
+    if (hosting.kind !== "cursor-managed-persistent") {
+        return undefined;
+    }
+    return {
+        logsDir: input.logsDir,
+        sink: cursorHostedFiles({
+            resolveStoreSourceId: () => hosting.resolveStoreIds().frameworkStoreSourceId,
+            resolveApiKey: () => resolveApiKeySync()?.apiKey,
+        }),
+        agentName: input.project.name,
+        logger: input.logger ?? (() => { }),
+    };
+}
+/**
+ * Start the directory sync and return a stop that flushes once more. The
+ * interval does not keep the process alive on its own. A tick that lands
+ * while a sync is running is dropped; stop still runs one more after it.
+ */
+export function startPersistentStageLogMirror(mirror, options) {
+    const uploaded = new Map();
+    let stopped = false;
+    let syncing = false;
+    let chain = Promise.resolve();
+    const syncOnce = () => {
+        chain = chain
+            .then(() => syncPersistentStageLogDirectory({
+            dir: mirror.logsDir,
+            sink: mirror.sink,
+            agentName: mirror.agentName,
+            uploaded,
+            logger: mirror.logger,
+        }))
+            .catch((error) => {
+            mirror.logger(`[bdk] persistent-stage-logs: sync failed (${describeError(error)})`);
+        });
+        return chain;
+    };
+    const timer = setInterval(() => {
+        if (stopped || syncing) {
+            return;
+        }
+        syncing = true;
+        void syncOnce().finally(() => {
+            syncing = false;
+        });
+    }, options?.intervalMs ?? PERSISTENT_STAGE_LOG_SYNC_INTERVAL_MS);
+    timer.unref();
+    syncing = true;
+    void syncOnce().finally(() => {
+        syncing = false;
+    });
+    return {
+        stop: () => {
+            if (stopped) {
+                return chain;
+            }
+            stopped = true;
+            clearInterval(timer);
+            return syncOnce();
+        },
+    };
+}
+/**
+ * Upload changed files under `persistent-stage-logs/`, then drop keys for files that are
+ * no longer in the directory. A missing directory is a no-op, so a tick before
+ * the first stage command does not sweep a previous snapshot.
+ */
+export async function syncPersistentStageLogDirectory(args) {
+    const logger = args.logger ?? (() => { });
+    const maxBytes = args.maxBytes ?? START_LOG_STORE_MAX_BYTES;
+    let entries;
+    try {
+        entries = await readdir(args.dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isEnoent(error)) {
+            return;
+        }
+        logger(`[bdk] persistent-stage-logs: read dir failed (${describeError(error)})`);
+        return;
+    }
+    const desired = new Set();
+    const names = entries
+        .filter((entry) => entry.isFile() && PERSISTENT_STAGE_LOG_FILE_NAME.test(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+    for (const name of names) {
+        const path = join(args.dir, name);
+        let fileStat;
+        try {
+            fileStat = await stat(path);
+        }
+        catch (error) {
+            if (isEnoent(error)) {
+                continue;
+            }
+            // Keep the previous snapshot when this tick cannot see the file.
+            logger(`[bdk] persistent-stage-logs: read failed for ${name} (${describeError(error)})`);
+            desired.add(name);
+            continue;
+        }
+        if (fileStat.size === 0) {
+            continue;
+        }
+        const previous = args.uploaded.get(name);
+        if (previous?.size === fileStat.size && previous.mtimeMs === fileStat.mtimeMs) {
+            desired.add(name);
+            continue;
+        }
+        let raw;
+        try {
+            raw = await readLogTail(path, fileStat.size, maxBytes);
+        }
+        catch (error) {
+            if (isEnoent(error)) {
+                continue;
+            }
+            logger(`[bdk] persistent-stage-logs: read failed for ${name} (${describeError(error)})`);
+            desired.add(name);
+            continue;
+        }
+        if (raw.length === 0) {
+            desired.add(name);
+            continue;
+        }
+        const body = maskStartLogTokens(raw);
+        desired.add(name);
+        const key = agentSdkStorageKeys.persistentStageLog(args.agentName, name);
+        try {
+            await args.sink.put(key, new TextEncoder().encode(body));
+            args.uploaded.set(name, { size: fileStat.size, mtimeMs: fileStat.mtimeMs });
+        }
+        catch (error) {
+            logger(`[bdk] persistent-stage-logs: persist failed for ${name} (${describeError(error)})`);
+        }
+    }
+    const prefix = agentSdkStorageKeys.persistentStageLogsPrefix(args.agentName);
+    let listed;
+    try {
+        listed = await args.sink.list(prefix);
+    }
+    catch (error) {
+        logger(`[bdk] persistent-stage-logs: list failed (${describeError(error)})`);
+        return;
+    }
+    for (const item of listed) {
+        const name = fileNameFromPersistentStageLogKey(item.key, prefix);
+        if (name === undefined || desired.has(name)) {
+            continue;
+        }
+        try {
+            await args.sink.delete(item.key);
+            args.uploaded.delete(name);
+        }
+        catch (error) {
+            logger(`[bdk] persistent-stage-logs: delete failed for ${name} (${describeError(error)})`);
+        }
+    }
+}
+/** Read the last `maxBytes` of a file without loading the rest of it. */
+async function readLogTail(path, size, maxBytes) {
+    const length = Math.min(size, maxBytes);
+    const position = size - length;
+    const handle = await open(path, "r");
+    try {
+        const buffer = Buffer.alloc(length);
+        let offset = 0;
+        while (offset < length) {
+            const { bytesRead } = await handle.read(buffer, offset, length - offset, position + offset);
+            if (bytesRead === 0) {
+                break;
+            }
+            offset += bytesRead;
+        }
+        return new TextDecoder().decode(buffer.subarray(0, offset));
+    }
+    finally {
+        await handle.close();
+    }
+}
+function fileNameFromPersistentStageLogKey(key, prefix) {
+    if (!key.startsWith(prefix)) {
+        return undefined;
+    }
+    const segment = key.slice(prefix.length);
+    if (segment.length === 0 || segment.includes("/")) {
+        return undefined;
+    }
+    try {
+        const name = decodeURIComponent(segment);
+        return PERSISTENT_STAGE_LOG_FILE_NAME.test(name) ? name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isEnoent(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "ENOENT");
+}

package/dist/internal/platform-schedule-sync.js

@@ -8,7 +8,7 @@ import { dirname } from "node:path";
 export const PLATFORM_SCHEDULE_CATALOG_FILENAME = "platform-schedule-names.json";
 export async function syncHostedPlatformSchedules(args) {
     const previous = await readScheduleCatalog(args.catalogPath);
-    const currentNames = args.schedules.map(schedule => schedule.name);
+    const currentNames = args.schedules.map((schedule) => schedule.name);
     const currentSet = new Set(currentNames);
     const failedDeletes = [];
     for (const name of previous) {

package/dist/internal/platform-timers.js

@@ -110,7 +110,7 @@ const AGENTSDK_REMINDERS_PREFIX = "/internal/agentsdk";
 const APPLY_REMINDER_OUTCOME_MAX_ATTEMPTS = 3;
 const APPLY_REMINDER_OUTCOME_RETRY_DELAY_MS = 50;
 async function sleepMs(ms) {
-    await new Promise(resolve => setTimeout(resolve, ms));
+    await new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function withBoundedApplyRetries(run) {
     let lastError;