@cursor/bdk 0.2.9 → 0.2.11

package/dist/memory.js

@@ -18,15 +18,6 @@
  * file tools keep the same read path. Local development uses
  * {@link fileMemoryBackend}.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { randomUUID } from "node:crypto";
 import { appendFile, mkdir, rename, stat, writeFile } from "node:fs/promises";
 import { join } from "node:path";
@@ -42,8 +33,7 @@ export const MEMORY_DIR_NAME = "memory";
  * segments stay alongside as `journal-<epoch-ms>.jsonl`.
  */
 export function fileMemoryBackend(options = {}) {
-    var _a;
-    const maxJournalBytes = (_a = options.maxJournalBytes) !== null && _a !== void 0 ? _a : 5 * 1024 * 1024;
+    const maxJournalBytes = options.maxJournalBytes ?? 5 * 1024 * 1024;
     // Event dispatch is serialized per session but concurrent across
     // sessions, so appends to the shared journal are chained per path. A
     // failed append must not poison the chain for later turns.
@@ -52,28 +42,23 @@ export function fileMemoryBackend(options = {}) {
     // rename would silently replace the earlier archive.
     let rotationSeq = 0;
     return {
-        appendTurn(record, ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                var _a;
-                const dir = join(ctx.stateRoot, MEMORY_DIR_NAME);
-                const path = join(dir, "journal.jsonl");
-                const prior = (_a = appendChains.get(path)) !== null && _a !== void 0 ? _a : Promise.resolve();
-                const next = prior
-                    .catch(() => { })
-                    .then(() => __awaiter(this, void 0, void 0, function* () {
-                    var _a;
-                    var _b;
-                    yield mkdir(dir, { recursive: true });
-                    const size = (_b = (_a = (yield stat(path).catch(() => undefined))) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 0;
-                    if (size >= maxJournalBytes) {
-                        rotationSeq += 1;
-                        yield rename(path, join(dir, `journal-${Date.now()}-${rotationSeq}.jsonl`));
-                    }
-                    yield appendFile(path, `${JSON.stringify(record)}\n`, "utf8");
-                }));
-                appendChains.set(path, next);
-                yield next;
+        async appendTurn(record, ctx) {
+            const dir = join(ctx.stateRoot, MEMORY_DIR_NAME);
+            const path = join(dir, "journal.jsonl");
+            const prior = appendChains.get(path) ?? Promise.resolve();
+            const next = prior
+                .catch(() => { })
+                .then(async () => {
+                await mkdir(dir, { recursive: true });
+                const size = (await stat(path).catch(() => undefined))?.size ?? 0;
+                if (size >= maxJournalBytes) {
+                    rotationSeq += 1;
+                    await rename(path, join(dir, `journal-${Date.now()}-${rotationSeq}.jsonl`));
+                }
+                await appendFile(path, `${JSON.stringify(record)}\n`, "utf8");
             });
+            appendChains.set(path, next);
+            await next;
         },
     };
 }
@@ -84,15 +69,14 @@ export function fileMemoryBackend(options = {}) {
  * persistence path.
  */
 export function agentStoreMemoryBackend(options = {}) {
-    var _a, _b, _c;
-    const hosted = (_a = options.hosted) !== null && _a !== void 0 ? _a : {};
-    const maxJournalBytes = (_b = options.maxJournalBytes) !== null && _b !== void 0 ? _b : 5 * 1024 * 1024;
+    const hosted = options.hosted ?? {};
+    const maxJournalBytes = options.maxJournalBytes ?? 5 * 1024 * 1024;
     // Mirror work is chained per journal key (same shape as
     // fileMemoryBackend): hydration and appends on one agent's mirror never
     // interleave, and a failed step must not poison the chain for later turns.
     const appendChains = new Map();
     // The client owns retries and typed errors; this module owns memory policy.
-    const storeApiClient = (_c = options.storeApiClient) !== null && _c !== void 0 ? _c : createStoreApiClient(hosted);
+    const storeApiClient = options.storeApiClient ?? createStoreApiClient(hosted);
     /**
      * Keep the local journal mirror available to file tools. Hydrate it when
      * absent, then append each record only after managed storage accepts it.
@@ -101,9 +85,7 @@ export function agentStoreMemoryBackend(options = {}) {
      */
     const hydratedMirrors = new Set();
     let mirrorRotationSeq = 0;
-    const maintainLocalMirror = (record, ctx) => __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        var _b;
+    const maintainLocalMirror = async (record, ctx) => {
         const dir = join(ctx.stateRoot, MEMORY_DIR_NAME);
         const path = join(dir, "journal.jsonl");
         if (!hydratedMirrors.has(path)) {
@@ -111,24 +93,24 @@ export function agentStoreMemoryBackend(options = {}) {
             // itself for one agent. Backstop for a session that appended before
             // any prepareSession hydration ran (e.g. a custom hook ordering).
             hydratedMirrors.add(path);
-            const existing = yield stat(path).catch(() => undefined);
+            const existing = await stat(path).catch(() => undefined);
             if (existing === undefined) {
-                const content = yield storeApiClient.memoryReadContent({
+                const content = await storeApiClient.memoryReadContent({
                     agent: ctx.agentName,
                 });
                 if (content !== undefined) {
-                    yield mirrorJournalLocally(ctx.stateRoot, content);
+                    await mirrorJournalLocally(ctx.stateRoot, content);
                 }
             }
         }
-        yield mkdir(dir, { recursive: true });
-        const size = (_b = (_a = (yield stat(path).catch(() => undefined))) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 0;
+        await mkdir(dir, { recursive: true });
+        const size = (await stat(path).catch(() => undefined))?.size ?? 0;
         if (size >= maxJournalBytes) {
             mirrorRotationSeq += 1;
-            yield rename(path, join(dir, `journal-${Date.now()}-${mirrorRotationSeq}.jsonl`));
+            await rename(path, join(dir, `journal-${Date.now()}-${mirrorRotationSeq}.jsonl`));
         }
-        yield appendFile(path, `${JSON.stringify(record)}\n`, "utf8");
-    });
+        await appendFile(path, `${JSON.stringify(record)}\n`, "utf8");
+    };
     /**
      * Append one record to managed storage, then update the local mirror.
      *
@@ -136,39 +118,37 @@ export function agentStoreMemoryBackend(options = {}) {
      * the hook runner treats an append failure as non-fatal to the turn;
      * a failed durable write also skips the mirror.
      */
-    const appendViaStoreApi = (record, ctx) => __awaiter(this, void 0, void 0, function* () {
+    const appendViaStoreApi = async (record, ctx) => {
         try {
-            yield storeApiClient.memoryAppend({ agent: ctx.agentName, record });
+            await storeApiClient.memoryAppend({ agent: ctx.agentName, record });
         }
         catch (error) {
             console.warn(`[bdk] memory.append dropped one record for "${ctx.agentName}": ${error instanceof Error ? error.message : String(error)}`);
             return;
         }
         try {
-            yield maintainLocalMirror(record, ctx);
+            await maintainLocalMirror(record, ctx);
         }
         catch (error) {
             console.warn(`[bdk] memory mirror update failed for "${ctx.agentName}" (journal record is durable): ${error instanceof Error ? error.message : String(error)}`);
         }
-    });
+    };
     /**
      * Refresh the local mirror at session start. Soft-fail so an unavailable
      * store does not erase the existing mirror.
      */
-    const hydrateMirror = (ctx) => __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        var _b;
+    const hydrateMirror = async (ctx) => {
         const path = join(ctx.stateRoot, MEMORY_DIR_NAME, "journal.jsonl");
         try {
-            const content = yield storeApiClient.memoryReadContent({
+            const content = await storeApiClient.memoryReadContent({
                 agent: ctx.agentName,
             });
             if (content !== undefined) {
                 // Never replace the local mirror with a shorter journal. Keeping the
                 // richer view avoids hiding records the agent has already seen.
-                const mirroredBytes = (_b = (_a = (yield stat(path).catch(() => undefined))) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 0;
+                const mirroredBytes = (await stat(path).catch(() => undefined))?.size ?? 0;
                 if (content.byteLength >= mirroredBytes) {
-                    yield mirrorJournalLocally(ctx.stateRoot, content);
+                    await mirrorJournalLocally(ctx.stateRoot, content);
                 }
             }
             // Either way the read answered: skip the append path's absent-file
@@ -178,65 +158,57 @@ export function agentStoreMemoryBackend(options = {}) {
         catch (error) {
             console.warn(`[bdk] memory hydration failed for "${ctx.agentName}" (keeping the existing mirror): ${error instanceof Error ? error.message : String(error)}`);
         }
-    });
+    };
     /** Report a missing managed-storage binding without falling back locally. */
     const refuseMisconfiguredLane = (agentName, verb) => {
         console.error(`[bdk] memory ${verb} for "${agentName}" dropped: the store API lane is unavailable (missing/foreign AGENT_SERVE_STORE_PROTOCOL pin or no provisioned store). This BDK version has no client-side journal fallback; fix the hosting pin.`);
     };
     return {
-        prepareSession(ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                var _a;
-                // Chained on the same per-journal key as appends, so hydration never
-                // interleaves with an append's mirror write.
-                const key = agentStoreKeys.memoryJournal(ctx.agentName);
-                const prior = (_a = appendChains.get(key)) !== null && _a !== void 0 ? _a : Promise.resolve();
-                const next = prior
-                    .catch(() => { })
-                    .then(() => __awaiter(this, void 0, void 0, function* () {
-                    if (!isStoreApiLaneEnabled(hosted)) {
-                        refuseMisconfiguredLane(ctx.agentName, "hydration");
-                        return;
-                    }
-                    yield hydrateMirror(ctx);
-                }));
-                appendChains.set(key, next);
-                yield next;
+        async prepareSession(ctx) {
+            // Chained on the same per-journal key as appends, so hydration never
+            // interleaves with an append's mirror write.
+            const key = agentStoreKeys.memoryJournal(ctx.agentName);
+            const prior = appendChains.get(key) ?? Promise.resolve();
+            const next = prior
+                .catch(() => { })
+                .then(async () => {
+                if (!isStoreApiLaneEnabled(hosted)) {
+                    refuseMisconfiguredLane(ctx.agentName, "hydration");
+                    return;
+                }
+                await hydrateMirror(ctx);
             });
+            appendChains.set(key, next);
+            await next;
         },
-        appendTurn(record, ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                var _a;
-                // Soft-fail by construction (appendViaStoreApi never throws), but
-                // still chained per journal key: the local mirror's hydrate-then-
-                // append must not interleave with itself. Availability is resolved
-                // lazily for each append.
-                const key = agentStoreKeys.memoryJournal(ctx.agentName);
-                const prior = (_a = appendChains.get(key)) !== null && _a !== void 0 ? _a : Promise.resolve();
-                const next = prior
-                    .catch(() => { })
-                    .then(() => __awaiter(this, void 0, void 0, function* () {
-                    if (!isStoreApiLaneEnabled(hosted)) {
-                        refuseMisconfiguredLane(ctx.agentName, "append");
-                        return;
-                    }
-                    yield appendViaStoreApi(record, ctx);
-                }));
-                appendChains.set(key, next);
-                yield next;
+        async appendTurn(record, ctx) {
+            // Soft-fail by construction (appendViaStoreApi never throws), but
+            // still chained per journal key: the local mirror's hydrate-then-
+            // append must not interleave with itself. Availability is resolved
+            // lazily for each append.
+            const key = agentStoreKeys.memoryJournal(ctx.agentName);
+            const prior = appendChains.get(key) ?? Promise.resolve();
+            const next = prior
+                .catch(() => { })
+                .then(async () => {
+                if (!isStoreApiLaneEnabled(hosted)) {
+                    refuseMisconfiguredLane(ctx.agentName, "append");
+                    return;
+                }
+                await appendViaStoreApi(record, ctx);
             });
+            appendChains.set(key, next);
+            await next;
         },
     };
 }
 /** Atomic full rewrite of the local mirror. */
-function mirrorJournalLocally(stateRoot, contents) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const dir = join(stateRoot, MEMORY_DIR_NAME);
-        yield mkdir(dir, { recursive: true });
-        const tmp = join(dir, `.tmp-${randomUUID()}`);
-        yield writeFile(tmp, contents);
-        yield rename(tmp, join(dir, "journal.jsonl"));
-    });
+async function mirrorJournalLocally(stateRoot, contents) {
+    const dir = join(stateRoot, MEMORY_DIR_NAME);
+    await mkdir(dir, { recursive: true });
+    const tmp = join(dir, `.tmp-${randomUUID()}`);
+    await writeFile(tmp, contents);
+    await rename(tmp, join(dir, "journal.jsonl"));
 }
 /** Cursor-managed deployments use durable memory; local development uses files. */
 function defaultMemoryBackend() {
@@ -259,16 +231,15 @@ function truncate(text, max) {
  * memories live; delete the hook file to opt out entirely.
  */
 export function memoryHook(options = {}) {
-    var _a, _b;
-    const backend = (_a = options.backend) !== null && _a !== void 0 ? _a : defaultMemoryBackend();
-    const maxTextLength = (_b = options.maxTextLength) !== null && _b !== void 0 ? _b : 2000;
+    const backend = options.backend ?? defaultMemoryBackend();
+    const maxTextLength = options.maxTextLength ?? 2000;
     // Inbound message per turn (truncated at receipt so large pastes are not
     // retained), keyed `<sessionId>/<turnId>` — `message.received` and the
     // turn-end events share a turnId. Entries drop at turn end and any
     // stragglers (turns that never reached a terminal event) at session end.
     const pendingMessages = new Map();
-    const pendingKey = (ctx, turnId) => `${ctx.session.id}/${turnId !== null && turnId !== void 0 ? turnId : "?"}`;
-    const record = (ctx, turnId, status, result, usage) => __awaiter(this, void 0, void 0, function* () {
+    const pendingKey = (ctx, turnId) => `${ctx.session.id}/${turnId ?? "?"}`;
+    const record = async (ctx, turnId, status, result, usage) => {
         const key = pendingKey(ctx, turnId);
         const userMessage = pendingMessages.get(key);
         pendingMessages.delete(key);
@@ -293,11 +264,11 @@ export function memoryHook(options = {}) {
         if (usage !== undefined) {
             entry.usage = usage;
         }
-        yield backend.appendTurn(entry, {
+        await backend.appendTurn(entry, {
             stateRoot: ctx.stateRoot,
             agentName: ctx.agent.name,
         });
-    });
+    };
     const sweepSession = (ctx) => {
         for (const key of pendingMessages.keys()) {
             if (key.startsWith(`${ctx.session.id}/`)) {
@@ -307,48 +278,35 @@ export function memoryHook(options = {}) {
     };
     return defineHook({
         events: {
-            "session.started"(_event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    var _a;
-                    // Bring the mirror (the workspace symlink read path) up to date
-                    // before the session's first turn reads it. Backends without a
-                    // prepareSession (plain files) have nothing to freshen. Soft-fail:
-                    // hydration is a freshness upgrade, never a turn blocker.
-                    try {
-                        yield (_a = backend.prepareSession) === null || _a === void 0 ? void 0 : _a.call(backend, {
-                            stateRoot: ctx.stateRoot,
-                            agentName: ctx.agent.name,
-                        });
-                    }
-                    catch (error) {
-                        console.warn(`[bdk] memory hydration at session start failed: ${error instanceof Error ? error.message : String(error)}`);
-                    }
-                });
+            async "session.started"(_event, ctx) {
+                // Bring the mirror (the workspace symlink read path) up to date
+                // before the session's first turn reads it. Backends without a
+                // prepareSession (plain files) have nothing to freshen. Soft-fail:
+                // hydration is a freshness upgrade, never a turn blocker.
+                try {
+                    await backend.prepareSession?.({
+                        stateRoot: ctx.stateRoot,
+                        agentName: ctx.agent.name,
+                    });
+                }
+                catch (error) {
+                    console.warn(`[bdk] memory hydration at session start failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
             },
-            "message.received"(event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    pendingMessages.set(pendingKey(ctx, event.turnId), truncate(event.data.text, maxTextLength));
-                });
+            async "message.received"(event, ctx) {
+                pendingMessages.set(pendingKey(ctx, event.turnId), truncate(event.data.text, maxTextLength));
             },
-            "turn.completed"(event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    yield record(ctx, event.turnId, "completed", event.data.result, event.data.usage);
-                });
+            async "turn.completed"(event, ctx) {
+                await record(ctx, event.turnId, "completed", event.data.result, event.data.usage);
             },
-            "turn.failed"(event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    yield record(ctx, event.turnId, "failed", event.data.message, undefined);
-                });
+            async "turn.failed"(event, ctx) {
+                await record(ctx, event.turnId, "failed", event.data.message, undefined);
             },
-            "session.completed"(_event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    sweepSession(ctx);
-                });
+            async "session.completed"(_event, ctx) {
+                sweepSession(ctx);
             },
-            "session.failed"(_event, ctx) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    sweepSession(ctx);
-                });
+            async "session.failed"(_event, ctx) {
+                sweepSession(ctx);
             },
         },
     });

package/dist/otel.js

@@ -116,8 +116,7 @@ export function formatTraceparent(spanContext) {
  * are per `@opentelemetry/api` copy.
  */
 export function injectActiveTraceContext(headers) {
-    var _a;
-    const span = (_a = trace.getSpan(context.active())) !== null && _a !== void 0 ? _a : getContextTracerSpan();
+    const span = trace.getSpan(context.active()) ?? getContextTracerSpan();
     if (span === undefined) {
         return;
     }
@@ -130,10 +129,9 @@ export function injectActiveTraceContext(headers) {
 }
 /** W3C `traceparent` for the active span, or undefined if none. */
 export function activeTraceparent() {
-    var _a;
     const headers = new Headers();
     injectActiveTraceContext(headers);
-    return (_a = headers.get(TRACEPARENT_HEADER)) !== null && _a !== void 0 ? _a : undefined;
+    return headers.get(TRACEPARENT_HEADER) ?? undefined;
 }
 /**
  * Copy the active span onto every outbound `fetch`. Agents should not
@@ -143,7 +141,7 @@ export function activeTraceparent() {
 function headersForFetch(input, init) {
     // Fetch: `init.headers` replaces `Request` headers. If `init` omits
     // headers (`fetch(request, { signal })`), keep the Request's.
-    const headers = new Headers((init === null || init === void 0 ? void 0 : init.headers) !== undefined
+    const headers = new Headers(init?.headers !== undefined
         ? init.headers
         : input instanceof Request
             ? input.headers
@@ -157,7 +155,7 @@ export function instrumentedFetch(base = fetch) {
         if (input instanceof Request && init === undefined) {
             return base(new Request(input, { headers }));
         }
-        return base(input, Object.assign(Object.assign({}, init), { headers }));
+        return base(input, { ...init, headers });
     };
 }
 const OUTBOUND_FETCH_INSTALLED = Symbol.for("anysphere.july.otel.outboundFetch");
@@ -180,7 +178,6 @@ function ensureContextTracerAls() {
 }
 ensureContextTracerAls();
 function getContextTracerSpan() {
-    var _a;
     const als = globalThis[ACTIVE_OTEL_SPAN_ALS];
-    return (_a = als === null || als === void 0 ? void 0 : als.getStore) === null || _a === void 0 ? void 0 : _a.call(als);
+    return als?.getStore?.();
 }