@cursor/bdk 0.2.18 → 0.2.20

package/dist/internal/session-engine.js

@@ -26,7 +26,7 @@ import { assertTimeArgs, normalizeAsOf, schemaTimeWindowKeys, sessionClock } fro
 import { SessionAuthError, samePrincipal } from "./auth.js";
 import { mergeChannelStateMutation, mergeChannelStateSkipNull } from "./channel-state.js";
 import { mergeCloudOptions, resolveSessionRuntime } from "./cloud-merge.js";
-import { applyCloudUsageToEvents, cloudSdkAgentIdFromEvents, isUnpricedCompletedTurn, mapSdkTokenUsage, } from "./cloud-turn-cost.js";
+import { applyCloudUsageToEvents, cloudSdkAgentIdFromEvents, isUsageMissingCompletedTurn, mapSdkTokenUsage, } from "./cloud-turn-usage.js";
 import { resolveConnectionEnvTemplates } from "./connection-env.js";
 import { applyAgentContinuationDefaults, channelContinuationIdentity, httpContinuationIdentity, } from "./continuation-channel.js";
 import { continuationSource, isOneShotContinuationKey, resolveV2Key, V2EngineError, } from "./continuation-identity.js";
@@ -61,7 +61,7 @@ import { StorageCoordinator, isTurnBoundaryEvent } from "./storage-coordinator.j
 import { decideToolCall, directCallEffect } from "./tool-policy.js";
 import { retryReadOnlyToolCall } from "./tool-call-retry.js";
 import { normalizeToolResult, toolCallErrorMessage } from "./tool-result.js";
-import { estimateTurnCostFromApi, roundCostUsd, } from "./turn-cost.js";
+import { estimateCostFromApi, roundCostUsd } from "./estimate-cost.js";
 import { TurnGovernor } from "./turn-governor.js";
 import { TurnLeaseStore } from "./turn-lease-store.js";
 import { TurnOutbox } from "./turn-outbox.js";
@@ -250,10 +250,10 @@ export class SessionEngine {
         this.oauthHub = new McpOauthOnDemandHub();
         /** Serve-time resolved connections (see {@link setResolvedConnections}). */
         this.resolvedConnections = [];
-        /** Sessions whose completed turns are fully priced (no further backfill). */
-        this.cloudCostBackfillDone = new Set();
-        /** Deduped in-flight cloud cost backfills, keyed by session id. */
-        this.cloudCostBackfill = new Map();
+        /** Sessions whose completed turns all carry usage (no further backfill). */
+        this.cloudUsageBackfillDone = new Set();
+        /** Deduped in-flight cloud usage backfills, keyed by session id. */
+        this.cloudUsageBackfill = new Map();
         /** Per-session FileSystem handle cache (not a tree snapshot). */
         this.sessionRoots = new Map();
         /** In-flight factory resolves, so the first turn and a racing callTool share one handle. */
@@ -266,7 +266,7 @@ export class SessionEngine {
         this.runner = options.runner;
         this.logger = options.logger ?? (() => { });
         this.getCloudUsage = options.getCloudUsage ?? defaultGetCloudUsage;
-        this.estimateTurnCost = options.estimateTurnCost ?? estimateTurnCostFromApi;
+        this.estimateSessionCost = options.estimateSessionCost ?? estimateCostFromApi;
         this.otel = options.otel;
         this.otelHost = createHostOtelApi({
             agentName: options.project.name,
@@ -1840,7 +1840,7 @@ export class SessionEngine {
         const finalUsage = outcome.usage ?? mapper.usage;
         const preBoundaryDispatch = this.dispatchChains.get(sessionId);
         if (outcome.status === "finished") {
-            const completed = await this.appendEvent(sessionId, {
+            await this.appendEvent(sessionId, {
                 type: "turn.completed",
                 turnId,
                 data: {
@@ -1848,15 +1848,6 @@ export class SessionEngine {
                     usage: finalUsage,
                 },
             }, eventContext);
-            if (finalUsage !== undefined) {
-                this.stampTurnCost(sessionId, completed, {
-                    model: this.turnModel(record).model ?? DEFAULT_MODEL,
-                    usage: finalUsage,
-                    agentId: record.sdkAgentId,
-                    conversationId: record.sdkAgentId ?? sessionId,
-                    runId: outcome.runId,
-                });
-            }
         }
         else {
             const interrupted = signal.aborted && outcome.status === "cancelled";
@@ -4011,8 +4002,8 @@ export class SessionEngine {
     }
     async eventStream(sessionId, startIndex = 0) {
         // Playground Trace replays this stream; backfill before the snapshot
-        // so historical Sherlock-style cloud turns can show billed cost.
-        await this.backfillCloudTurnCosts(sessionId);
+        // so cloud turns that lost their streamed usage still show tokens.
+        await this.backfillCloudTurnUsage(sessionId);
         const log = await this.logs.get(sessionId);
         return log.stream(startIndex);
     }
@@ -4063,133 +4054,82 @@ export class SessionEngine {
         await this.appendEvent(sessionId, { type: "eval.case.result", data });
     }
     /**
-     * Cost is a display figure resolved over the network, and the session holds
-     * its delivery lease until `turn.completed`, so it is stamped onto the
-     * recorded event afterwards rather than delaying the event. A host that
-     * stops before the estimate lands leaves the turn unpriced; `sessionCost`
-     * prices the session on read.
-     */
-    stampTurnCost(sessionId, completed, input) {
-        void this.priceTurn(input)
-            .then(async (cost) => {
-            if (cost === undefined || completed.type !== "turn.completed") {
-                return;
-            }
-            // Same object the turn.completed hook is waiting on.
-            completed.data = { ...completed.data, cost };
-            const log = await this.logs.get(sessionId);
-            log.replace(completed.index, completed);
-        })
-            .catch((error) => {
-            this.logger(`[bdk] turn cost stamp failed for ${sessionId}: ${describeError(error)}`);
-        });
-    }
-    async priceTurn(input) {
-        try {
-            return await this.estimateTurnCost(input);
-        }
-        catch (error) {
-            this.logger(`[bdk] turn cost estimate failed: ${describeError(error)}`);
-            return undefined;
-        }
-    }
-    /**
-     * Billed/catalog cost for a session. Powers playground, traces, and
-     * `agent-sdk cost` via `GET /v1/session/:id/cost`.
+     * Billed/catalog cost of the whole session, priced once per call. Powers
+     * the playground, `bdk run`, and `bdk cost` via `GET /v1/session/:id/cost`.
+     * The billed lookup is expensive, so nothing on the turn path calls this.
      */
     async sessionCost(sessionId) {
         const record = await this.getOrRestoreSession(sessionId);
         if (record === undefined) {
             throw new Error(`Unknown session: ${sessionId}`);
         }
-        await this.backfillCloudTurnCosts(sessionId);
+        await this.backfillCloudTurnUsage(sessionId);
         const events = await this.listEvents(sessionId);
         const sdkAgentId = (record.sdkAgentId !== undefined && record.sdkAgentId !== ""
             ? record.sdkAgentId
             : undefined) ?? cloudSdkAgentIdFromEvents(events);
-        const model = this.turnModel(record).model ?? DEFAULT_MODEL;
-        const priced = await this.estimateTurnCost({
-            model,
+        const priced = await this.estimateSessionCost({
+            model: this.turnModel(record).model ?? DEFAULT_MODEL,
+            usage: sumSessionUsage(events),
             agentId: sdkAgentId,
             conversationId: sdkAgentId ?? sessionId,
         });
-        if (priced !== undefined && (priced.source === "usage" || priced.totalUsd > 0)) {
+        if (priced === undefined || (priced.source !== "usage" && priced.totalUsd <= 0)) {
             return {
                 sessionId,
-                source: priced.source,
-                cost: {
-                    rawCostCents: priced.rawCostCents ?? priced.chargedCents ?? 0,
-                    chargedCents: priced.chargedCents ?? priced.totalUsd * 100,
-                },
-                costUsd: priced.totalUsd,
-                rawCostUsd: roundCostUsd((priced.rawCostCents ?? priced.chargedCents ?? priced.totalUsd * 100) / 100),
-                model: priced.model,
+                source: "unavailable",
+                cost: { rawCostCents: 0, chargedCents: 0 },
+                costUsd: 0,
+                rawCostUsd: 0,
             };
         }
-        let costUsd = 0;
-        let rawCostUsd = 0;
-        let source = "unavailable";
-        let modelId;
-        for (const event of events) {
-            if (event.type !== "turn.completed" || event.data.cost === undefined) {
-                continue;
-            }
-            costUsd = roundCostUsd(costUsd + event.data.cost.totalUsd);
-            const rawCents = event.data.cost.rawCostCents;
-            rawCostUsd = roundCostUsd(rawCostUsd + (rawCents !== undefined ? rawCents / 100 : event.data.cost.totalUsd));
-            source = event.data.cost.source;
-            modelId = event.data.cost.model;
-        }
         return {
             sessionId,
-            source,
-            cost: {
-                rawCostCents: rawCostUsd * 100,
-                chargedCents: costUsd * 100,
-            },
-            costUsd,
-            rawCostUsd,
-            model: modelId,
+            source: priced.source,
+            cost: { rawCostCents: priced.rawCostCents, chargedCents: priced.chargedCents },
+            costUsd: priced.totalUsd,
+            rawCostUsd: roundCostUsd(priced.rawCostCents / 100),
+            model: priced.model,
         };
     }
     /** Snapshot of recorded events (for download / offline trace). */
     async listEvents(sessionId, startIndex = 0, options) {
-        if (options?.backfillCloudCost === true) {
-            await this.backfillCloudTurnCosts(sessionId);
+        if (options?.backfillCloudUsage === true) {
+            await this.backfillCloudTurnUsage(sessionId);
         }
         const log = await this.logs.get(sessionId);
         return log.snapshot(startIndex);
     }
     /**
-     * Historical cloud turns may lack usage/cost on `turn.completed` (pre-0.1.29
-     * engines, or getUsage still zero at turn end). Fill them from billed usage
-     * before the playground replays the stream so Trace can show cost.
+     * Cloud turns may lack usage on `turn.completed` (pre-0.1.29 engines, or
+     * getUsage still zero at turn end). Fill them from billed usage before the
+     * playground replays the stream so Trace can show their tokens.
      */
-    backfillCloudTurnCosts(sessionId) {
-        if (this.cloudCostBackfillDone.has(sessionId)) {
+    backfillCloudTurnUsage(sessionId) {
+        if (this.cloudUsageBackfillDone.has(sessionId)) {
             return Promise.resolve();
         }
-        const pending = this.cloudCostBackfill.get(sessionId);
+        const pending = this.cloudUsageBackfill.get(sessionId);
         if (pending !== undefined) {
             return pending;
         }
-        const work = this.runCloudTurnCostBackfill(sessionId)
+        const work = this.runCloudTurnUsageBackfill(sessionId)
             .catch((error) => {
-            this.logger(`[bdk] cloud cost backfill failed for ${sessionId}: ${describeError(error)}`);
+            this.logger(`[bdk] cloud usage backfill failed for ${sessionId}: ${describeError(error)}`);
         })
             .finally(() => {
-            this.cloudCostBackfill.delete(sessionId);
+            this.cloudUsageBackfill.delete(sessionId);
         });
-        this.cloudCostBackfill.set(sessionId, work);
+        this.cloudUsageBackfill.set(sessionId, work);
         return work;
     }
-    async runCloudTurnCostBackfill(sessionId) {
+    async runCloudTurnUsageBackfill(sessionId) {
         const log = await this.logs.get(sessionId);
         const events = await log.snapshot(0);
-        if (!events.some((event) => isUnpricedCompletedTurn(event))) {
+        if (!events.some((event) => isUsageMissingCompletedTurn(event))) {
             if (!this.isTurnRunning(sessionId) &&
                 events.some((event) => event.type === "turn.completed")) {
-                this.cloudCostBackfillDone.add(sessionId);
+                this.cloudUsageBackfillDone.add(sessionId);
             }
             return;
         }
@@ -4203,8 +4143,7 @@ export class SessionEngine {
         if (billed === undefined) {
             return;
         }
-        const model = this.turnModel(record).model ?? DEFAULT_MODEL;
-        const patched = applyCloudUsageToEvents(events, billed, model);
+        const patched = applyCloudUsageToEvents(events, billed);
         if (patched === undefined) {
             return;
         }
@@ -4216,8 +4155,8 @@ export class SessionEngine {
             }
             log.replace(i, next);
         }
-        if (!(await log.snapshot(0)).some((event) => isUnpricedCompletedTurn(event))) {
-            this.cloudCostBackfillDone.add(sessionId);
+        if (!(await log.snapshot(0)).some((event) => isUsageMissingCompletedTurn(event))) {
+            this.cloudUsageBackfillDone.add(sessionId);
         }
     }
     async setContinuationToken(sessionId, token) {
@@ -4495,7 +4434,7 @@ export class SessionEngine {
         // storage coordinator skips volatile-only record rewrites, bounded).
         // New turnIds mint from turnCount, so clamp it to the highest turn the
         // stream already used; otherwise a replacement process re-mints turn_N ids
-        // and trajectory/cost grouping merges unrelated turns.
+        // and trajectory/usage grouping merges unrelated turns.
         const restored = withTurnCountClampedToEvents(record, events);
         await this.materializeSession(restored, eventsNdjson(events));
         this.logger(`[bdk] lazily restored session ${restored.sessionId} from storage`);
@@ -4645,17 +4584,31 @@ function toolErrorResult(message) {
         isError: true,
     };
 }
+/** Token usage summed over every completed turn; undefined when no turn reported any. */
+function sumSessionUsage(events) {
+    let total;
+    for (const event of events) {
+        if (event.type !== "turn.completed" || event.data.usage === undefined) {
+            continue;
+        }
+        const usage = event.data.usage;
+        total ??= { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 };
+        total.inputTokens += usage.inputTokens;
+        total.outputTokens += usage.outputTokens;
+        total.cacheReadTokens += usage.cacheReadTokens;
+        total.cacheWriteTokens += usage.cacheWriteTokens;
+    }
+    return total;
+}
 async function defaultGetCloudUsage(sdkAgentId) {
     try {
         const { Agent } = await import("@cursor/sdk");
         const billed = await Agent.getUsage(sdkAgentId);
         return {
             usage: mapSdkTokenUsage(billed.usage),
-            cost: billed.cost,
             runs: billed.runs.map((run) => ({
                 runId: run.runId,
                 usage: mapSdkTokenUsage(run.usage),
-                cost: run.cost,
             })),
         };
     }

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

@@ -3,7 +3,7 @@
  *
  * Customer-facing errors never include hosting URLs or infra jargon.
  */
-import type { SessionEvent, SessionListSource, SessionSummary } from "../types.js";
+import type { SessionCost, SessionEvent, SessionListSource, SessionSummary } from "../types.js";
 import { type RequestAuth } from "./request-headers.js";
 export interface ListedSessions {
     sessions: SessionSummary[];
@@ -29,6 +29,18 @@ export declare function fetchSessionEvents(args: {
     fetchImpl?: typeof fetch;
     signal?: AbortSignal;
 }): Promise<SessionEvent[]>;
+/**
+ * Whole-session cost from `GET /v1/session/:id/cost`. Undefined when the
+ * server cannot price the session or does not serve the route, so callers
+ * can treat cost as optional.
+ */
+export declare function fetchSessionCost(args: {
+    baseUrl: string;
+    sessionId: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<SessionCost | undefined>;
 /**
  * Pick the previous (most recently updated) followable session for
  * `resume` / `chat --resume` when no session id was passed.

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

@@ -1 +1 @@
-{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B5F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqE1B;AAkCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAQ5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvC,MAAM,CAgBR"}
+{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B5F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqE1B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsBnC;AAkCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAQ5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvC,MAAM,CAgBR"}

package/dist/internal/sessions-client.js

@@ -106,6 +106,30 @@ export async function fetchSessionEvents(args) {
         throw new Error(sanitizeCustomerError(error instanceof Error ? error.message : "Could not fetch session events."));
     }
 }
+/**
+ * Whole-session cost from `GET /v1/session/:id/cost`. Undefined when the
+ * server cannot price the session or does not serve the route, so callers
+ * can treat cost as optional.
+ */
+export async function fetchSessionCost(args) {
+    const baseUrl = args.baseUrl.replace(/\/$/, "");
+    const fetchImpl = args.fetchImpl ?? fetch;
+    try {
+        const resp = await fetchImpl(`${baseUrl}/v1/session/${encodeURIComponent(args.sessionId)}/cost`, { headers: mergeRequestHeaders(args.auth), signal: args.signal });
+        if (!resp.ok) {
+            return undefined;
+        }
+        const body = (await resp.json());
+        if (typeof body.costUsd !== "number" ||
+            (body.source !== "usage" && body.source !== "catalog")) {
+            return undefined;
+        }
+        return body;
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Lenient parse so partial stubs / older servers still list by sessionId. */
 function parseSessionSummary(value) {
     if (typeof value !== "object" || value === null) {

package/dist/internal/trajectory.d.ts

@@ -5,7 +5,7 @@
  * messages, assistant text, tool calls with args/results, and
  * success/failure — not a firehose of streaming deltas.
  */
-import type { SessionEvent, TurnCost, TurnUsage } from "../types.js";
+import type { SessionEvent, TurnUsage } from "../types.js";
 export interface TrajectoryToolCall {
     callId: string;
     toolName: string;
@@ -32,8 +32,6 @@ export interface TrajectoryTurn {
     toolCalls: TrajectoryToolCall[];
     subagents: TrajectorySubagent[];
     usage?: TurnUsage;
-    /** Estimated dollar cost of this turn (from the `turn.completed` event). */
-    cost?: TurnCost;
     result?: string;
     failed: boolean;
     error?: string;
@@ -47,7 +45,10 @@ export interface Trajectory {
     finalText: string;
     turnsFailed: number;
     toolCallCount: number;
-    /** Sum of per-turn estimated costs; present when any turn reported cost. */
+    /**
+     * The session's cost from `GET /v1/session/:id/cost`, priced once after the
+     * last turn. Never derived from events; absent when nobody priced it.
+     */
     totalCostUsd?: number;
     turns: TrajectoryTurn[];
 }
@@ -56,8 +57,6 @@ export interface Trajectory {
  * folded into final assistant / reasoning text per turn.
  */
 export declare function buildTrajectory(events: SessionEvent[]): Trajectory;
-/** Micro-dollar precision so summed floats stay readable in JSON. */
-export declare function roundCostUsd(usd: number): number;
 /** Compact dollar display for estimated costs (`$0.0132`, `$1.25`). */
 export declare function formatCostUsd(usd: number): string;
 /** Parse an `events.ndjson` file (or any NDJSON blob of SessionEvents). */

package/dist/internal/trajectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/internal/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACtC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CAwOlE;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAc9D;AAED,sDAAsD;AACtD,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAGpF;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAwDnE"}
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/internal/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACtC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CA+NlE;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAc9D;AAED,sDAAsD;AACtD,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAGpF;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAoDnE"}

package/dist/internal/trajectory.js

@@ -188,9 +188,6 @@ export function buildTrajectory(events) {
                 if (event.data.usage !== undefined) {
                     turn.usage = event.data.usage;
                 }
-                if (event.data.cost !== undefined) {
-                    turn.cost = event.data.cost;
-                }
                 if (event.data.result !== undefined) {
                     turn.result = event.data.result;
                     if (turn.assistantText === "") {
@@ -223,10 +220,6 @@ export function buildTrajectory(events) {
     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 totalCostUsd = costedTurns.length === 0
-        ? undefined
-        : roundCostUsd(costedTurns.reduce((sum, t) => sum + (t.cost?.totalUsd ?? 0), 0));
     return {
         sessionId,
         ...(sdkAgentId === undefined ? {} : { sdkAgentId }),
@@ -236,14 +229,9 @@ export function buildTrajectory(events) {
         finalText: lastGood?.assistantText ?? "",
         turnsFailed,
         toolCallCount,
-        ...(totalCostUsd === undefined ? {} : { totalCostUsd }),
         turns,
     };
 }
-/** Micro-dollar precision so summed floats stay readable in JSON. */
-export function roundCostUsd(usd) {
-    return Math.round(usd * 1e6) / 1e6;
-}
 /** Compact dollar display for estimated costs (`$0.0132`, `$1.25`). */
 export function formatCostUsd(usd) {
     if (!Number.isFinite(usd)) {
@@ -324,7 +312,7 @@ export function formatTrajectoryText(trajectory) {
             lines.push(`  error: ${turn.error}`);
         }
         if (turn.usage !== undefined) {
-            lines.push(`  usage: in ${turn.usage.inputTokens} out ${turn.usage.outputTokens}${turn.cost === undefined ? "" : `  cost: ${formatCostUsd(turn.cost.totalUsd)}`}`);
+            lines.push(`  usage: in ${turn.usage.inputTokens} out ${turn.usage.outputTokens}`);
         }
     }
     return `${lines.join("\n")}\n`;

package/dist/memory.d.ts

@@ -90,14 +90,17 @@ export interface AgentStoreMemoryBackendOptions {
  */
 export declare function agentStoreMemoryBackend(options?: AgentStoreMemoryBackendOptions): MemoryBackend;
 export interface MemoryHookOptions {
-    /** Where records go. Defaults to {@link fileMemoryBackend}. */
+    /**
+     * Where records go. Defaults to {@link agentStoreMemoryBackend} on
+     * Cursor-managed hosting and {@link fileMemoryBackend} elsewhere.
+     */
     backend?: MemoryBackend;
     /** Truncation cap for stored userMessage / result text. Default 2000. */
     maxTextLength?: number;
 }
 /**
  * Observe-only hook that journals every turn. Author it as
- * `agent/hooks/memory.ts`:
+ * `bot/hooks/memory.ts`:
  *
  * ```ts
  * import { memoryHook } from "@cursor/bdk/memory";

package/dist/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAe,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE,sEAAsE;AACtE,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,UAAU,CACR,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;;;OAKG;IACH,cAAc,CAAC,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa,CA6BvF;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,uCAAuC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,aAAa,CA6Jf;AAgBD,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAgG1E"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAe,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE,sEAAsE;AACtE,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,UAAU,CACR,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;;;OAKG;IACH,cAAc,CAAC,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa,CA6BvF;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,uCAAuC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,aAAa,CA6Jf;AAgBD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAgG1E"}

package/dist/memory.js

@@ -219,7 +219,7 @@ function truncate(text, max) {
 }
 /**
  * Observe-only hook that journals every turn. Author it as
- * `agent/hooks/memory.ts`:
+ * `bot/hooks/memory.ts`:
  *
  * ```ts
  * import { memoryHook } from "@cursor/bdk/memory";