@cursor/july 0.1.25 → 0.1.27

package/dist/internal/session-engine.js

@@ -31,11 +31,12 @@ import { dirname, join } from "node:path";
 import { mergeABInstructions, resolveABMaxPlaygroundSessions, resolveABSplit, } from "../ab.js";
 import { slackThreadPermalink } from "../channels/slack/links.js";
 import { SlackAskDedupeStore, SlackNudgeStore, } from "../channels/slack/nudge-store.js";
-import { DIRECT_TOOL_CALL_CHANNEL_ID, isHostOauthConnectionTransport, isSymbolicConnectionTransport, } from "../types.js";
+import { DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isHostOauthConnectionTransport, isSymbolicConnectionTransport, } from "../types.js";
 import { ABCollector } from "./ab-collector.js";
 import { foldABStream } from "./ab-fold.js";
 import { buildABSnapshot } from "./ab-snapshot.js";
 import { ApprovalGate } from "./approval-gate.js";
+import { ArtifactsStore } from "./artifacts-store.js";
 import { samePrincipal } from "./auth.js";
 import { mergeCloudOptions, resolveSessionRuntime } from "./cloud-merge.js";
 import { isDevMode } from "./dev-mode.js";
@@ -46,6 +47,7 @@ import { createHostPlatforms } from "./host-platforms.js";
 import { formatContinuationToken, newContinuationKey, newSessionId, newToolCallId, } from "./ids.js";
 import { validateToolInput } from "./json-schema.js";
 import { McpHost } from "./mcp-host.js";
+import { estimateTurnCost } from "./model-pricing.js";
 import { buildSessionContextBlock, SCHEDULE_CHANNEL_PREFIX, } from "./prompt-context.js";
 import { assertCloudCanHonorAccountServersFilters } from "./resolved-connections.js";
 import { SessionStore } from "./session-store.js";
@@ -159,6 +161,11 @@ export class SessionEngine {
                     logger: this.logger,
                 });
         this.kvApi = createHostKvApi(Object.assign({ agentName: options.project.name, stateRoot: options.stateRoot }, (this.storage === undefined ? {} : { storage: this.storage })));
+        this.artifactsStore = new ArtifactsStore({
+            stateRoot: options.stateRoot,
+            storage: this.storage,
+            config: options.project.artifacts,
+        });
         this.abCollector = new ABCollector(options.project.abs, this.logger, (sessionId) => __awaiter(this, void 0, void 0, function* () { return (yield this.logs.get(sessionId)).snapshot(0); }), 
         // Samples flow to the defineStorage `abs` table (no-op without one).
         { persistSample: (sample) => { var _a; return (_a = this.storage) === null || _a === void 0 ? void 0 : _a.abSample(sample); } });
@@ -200,6 +207,67 @@ export class SessionEngine {
             slackNudges: this.slackNudgeHostApi(),
         };
     }
+    /** Unbound `ctx.artifacts` facade (channel handlers, scratch tool calls). */
+    get artifacts() {
+        return this.artifactsApi();
+    }
+    /**
+     * Build one `ctx.artifacts` facade over the engine-owned artifacts
+     * service. With a `binding` (tools, hooks) `tag` auto-fills the bound
+     * session (and turn when known) and rejects a conflicting explicit
+     * `sessionId`; without one (channel handlers) callers may pass
+     * `sessionId` / `turnId` explicitly.
+     */
+    artifactsApi(binding) {
+        return {
+            tag: (input) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                if (binding === undefined) {
+                    return this.tagArtifact(input);
+                }
+                if (input.sessionId !== undefined &&
+                    input.sessionId !== binding.sessionId) {
+                    throw new Error(`artifacts.tag: this context is bound to session ${binding.sessionId}; cannot tag for ${input.sessionId}`);
+                }
+                return this.tagArtifact(Object.assign(Object.assign({}, input), { sessionId: binding.sessionId, turnId: (_a = input.turnId) !== null && _a !== void 0 ? _a : binding.turnId }));
+            }),
+            list: (filter) => this.artifactsStore.list(filter),
+        };
+    }
+    /**
+     * Single tag funnel: upsert the row, then — for session-bound tags —
+     * append `artifact.tagged` through {@link appendEvent} so persistence
+     * flush and hook fan-out are inherited. Session-less tags skip the event.
+     * An unknown `sessionId` rejects before the row is written (appending to
+     * a session that was never materialized here would mint an orphan local
+     * event log, breaking the local-over-sink restore invariant).
+     */
+    tagArtifact(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (input.sessionId !== undefined &&
+                (yield this.getOrRestoreSession(input.sessionId)) === undefined) {
+                throw new UnknownSessionError(input.sessionId);
+            }
+            const record = yield this.artifactsStore.tag(input);
+            if (record.sessionId !== undefined) {
+                yield this.appendEvent(record.sessionId, {
+                    type: "artifact.tagged",
+                    turnId: record.turnId,
+                    data: {
+                        id: record.id,
+                        kind: record.kind,
+                        key: record.key,
+                        title: record.title,
+                        data: record.data,
+                        source: record.source,
+                    },
+                });
+            }
+            this.logger(`[session] artifact tagged kind=${record.kind} id=${record.id} source=${record.source} session=${(_a = record.sessionId) !== null && _a !== void 0 ? _a : "-"} key=${(_b = record.key) !== null && _b !== void 0 ? _b : "-"}`);
+            return record;
+        });
+    }
     slackNudgeHostApi() {
         return {
             append: (input) => this.nudgeStore.append(input),
@@ -254,6 +322,14 @@ export class SessionEngine {
                 else if (options.workspaceFiles !== undefined) {
                     record = yield this.updateRecord(existing.sessionId, (current) => (Object.assign(Object.assign({}, current), { pendingWorkspaceFiles: options.workspaceFiles })));
                 }
+                // Refresh the cloud attach the same way: a follow-up send carries the
+                // caller's CURRENT cloud options (e.g. a PR attach re-derived per wake),
+                // and the first send's snapshot must not pin this session's turns to a
+                // stale repo/prUrl for the session's lifetime.
+                if (options.cloud !== undefined &&
+                    JSON.stringify(options.cloud) !== JSON.stringify(record.cloudOverride)) {
+                    record = yield this.updateRecord(record.sessionId, (current) => (Object.assign(Object.assign({}, current), { cloudOverride: options.cloud })));
+                }
                 const coalesced = yield this.startTurn(record.sessionId, message, Object.assign({ admission: (_c = options.admission) !== null && _c !== void 0 ? _c : "preempt" }, (options.coalesceSourceTs === undefined
                     ? {}
                     : { sourceTs: options.coalesceSourceTs })));
@@ -403,7 +479,10 @@ export class SessionEngine {
                     lastCreated = session;
                     return session;
                 });
-                const returned = yield definition.receive(input, { send });
+                const returned = yield definition.receive(input, {
+                    send,
+                    artifacts: this.artifactsApi(),
+                });
                 const session = returned !== null && returned !== void 0 ? returned : lastCreated;
                 if (session === undefined) {
                     throw new Error(`Channel "${channelId}" receive hook did not start a session`);
@@ -738,7 +817,7 @@ export class SessionEngine {
     }
     executeTurn(record, turnId, message, isFirstTurn, signal) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d, _e, _f;
             const sessionId = record.sessionId;
             const workspaceDir = this.scaffoldDir(record);
             const harnessCwd = this.harnessCwd(record);
@@ -836,11 +915,19 @@ export class SessionEngine {
             }
             const finalResult = (_a = outcome.result) !== null && _a !== void 0 ? _a : mapper.finalText;
             const finalUsage = (_b = outcome.usage) !== null && _b !== void 0 ? _b : mapper.usage;
+            // Estimated dollar cost of this loop pass, persisted alongside usage so
+            // traces / A/B metrics / the CLI can aggregate spend without re-pricing.
+            const finalCost = finalUsage === undefined
+                ? undefined
+                : estimateTurnCost((_c = this.project.agent.model) !== null && _c !== void 0 ? _c : DEFAULT_MODEL, finalUsage);
+            if (finalCost !== undefined) {
+                outcome = Object.assign(Object.assign({}, outcome), { cost: finalCost });
+            }
             if (outcome.status === "finished") {
                 yield this.appendEvent(sessionId, {
                     type: "turn.completed",
                     turnId,
-                    data: Object.assign(Object.assign({}, (finalResult === undefined ? {} : { result: finalResult })), (finalUsage === undefined ? {} : { usage: finalUsage })),
+                    data: Object.assign(Object.assign(Object.assign({}, (finalResult === undefined ? {} : { result: finalResult })), (finalUsage === undefined ? {} : { usage: finalUsage })), (finalCost === undefined ? {} : { cost: finalCost })),
                 });
             }
             else {
@@ -851,21 +938,21 @@ export class SessionEngine {
                     data: {
                         message: interrupted
                             ? "turn interrupted"
-                            : ((_c = outcome.errorMessage) !== null && _c !== void 0 ? _c : (outcome.status === "cancelled"
+                            : ((_d = outcome.errorMessage) !== null && _d !== void 0 ? _d : (outcome.status === "cancelled"
                                 ? "turn cancelled"
                                 : "turn failed")),
                     },
                 });
             }
             const current = yield this.sessions.get(sessionId);
-            const mode = (_d = current === null || current === void 0 ? void 0 : current.mode) !== null && _d !== void 0 ? _d : record.mode;
+            const mode = (_e = current === null || current === void 0 ? void 0 : current.mode) !== null && _e !== void 0 ? _e : record.mode;
             if (mode === "task") {
                 yield this.appendEvent(sessionId, outcome.status === "finished"
                     ? { type: "session.completed", turnId, data: {} }
                     : {
                         type: "session.failed",
                         turnId,
-                        data: { message: (_e = outcome.errorMessage) !== null && _e !== void 0 ? _e : "task failed" },
+                        data: { message: (_f = outcome.errorMessage) !== null && _f !== void 0 ? _f : "task failed" },
                     });
             }
             else {
@@ -1019,6 +1106,10 @@ export class SessionEngine {
                         workspaceDir: this.harnessCwd(record),
                         stateRoot: this.stateRoot,
                         host: this.host,
+                        artifacts: this.artifactsApi({
+                            sessionId: record.sessionId,
+                            turnId,
+                        }),
                         send: (channelId, message, sendOptions = {}) => this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: sendOptions.auth !== undefined
                                 ? sendOptions.auth
                                 : record.auth })),
@@ -1273,6 +1364,13 @@ export class SessionEngine {
                     workspaceDir,
                     stateRoot: this.stateRoot,
                     host: this.host,
+                    // Scratch calls have no real session; their facade stays unbound.
+                    artifacts: record === undefined
+                        ? this.artifactsApi()
+                        : this.artifactsApi({
+                            sessionId: record.sessionId,
+                            turnId: callId,
+                        }),
                     send: (channelId, message, sendOptions = {}) => this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: sendOptions.auth !== undefined
                             ? sendOptions.auth
                             : session.auth })),
@@ -1402,6 +1500,10 @@ export class SessionEngine {
                             },
                             session: this.sessionInfo(record),
                             stateRoot: this.stateRoot,
+                            artifacts: this.artifactsApi({
+                                sessionId: record.sessionId,
+                                turnId: event.turnId,
+                            }),
                         });
                     }
                     catch (error) {
@@ -1462,6 +1564,25 @@ export class SessionEngine {
             return (yield this.listSessionsWithSource(caller, options)).sessions;
         });
     }
+    /**
+     * Artifacts for `GET /v1/artifacts`, newest-updated first. Without
+     * `includeAll`, the sessions-list ownership rule applies: only artifacts
+     * tagged on a session whose principal matches the caller. Session-less
+     * artifacts are agent-scoped and visible only with `includeAll`.
+     */
+    listArtifacts(caller, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const records = yield this.artifactsStore.list(options === null || options === void 0 ? void 0 : options.filter);
+            if ((options === null || options === void 0 ? void 0 : options.includeAll) === true) {
+                return records;
+            }
+            const sessions = yield this.sessions.list();
+            const owned = new Set(sessions
+                .filter((record) => samePrincipal(record.auth, caller))
+                .map((record) => record.sessionId));
+            return records.filter((record) => record.sessionId !== undefined && owned.has(record.sessionId));
+        });
+    }
     /**
      * Same as {@link listSessions}, plus which store answered
      * (`cursor-hosted` = durable DB via the control-plane proxy; `local` =

package/dist/internal/storage-coordinator.d.ts

@@ -141,6 +141,21 @@ export declare class StorageCoordinator {
     kvPut(authorKey: string, value: JsonValue): Promise<void>;
     /** Awaited author KV delete. No-op when the sink omits `delete`. */
     kvDelete(authorKey: string): Promise<void>;
+    /**
+     * Whether the sink can serve awaited artifact rows: `get` (upsert
+     * read-back), `list` (listing + eviction), and `delete` (`max` cap
+     * eviction) are all required — without `delete` the retention cap
+     * could never evict, so rows fall back to the filesystem store.
+     */
+    get supportsArtifacts(): boolean;
+    /** Awaited artifact-row read. Errors propagate (read-after-write). */
+    artifactGet(id: string): Promise<JsonValue | undefined>;
+    /** Awaited artifact-row write (straight to the sink, like author KV). */
+    artifactPut(id: string, value: JsonValue): Promise<void>;
+    /** Awaited artifact-row delete. Errors propagate (cap eviction). */
+    artifactDelete(id: string): Promise<void>;
+    /** All artifact-row values for this agent. Errors propagate. */
+    artifactList(): Promise<JsonValue[]>;
     /**
      * Adapter over the sink's dedicated `evals` table for the playground
      * eval-run store. Undefined when the table is not configured — eval

package/dist/internal/storage-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-coordinator.d.ts","sourceRoot":"","sources":["../../src/internal/storage-coordinator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage-coordinator.d.ts","sourceRoot":"","sources":["../../src/internal/storage-coordinator.ts"],"names":[],"mappings":"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"}

package/dist/internal/storage-coordinator.js

@@ -390,6 +390,58 @@ export class StorageCoordinator {
         });
     }
     // ==========================================================================
+    // Artifacts (`ctx.artifacts`)
+    // ==========================================================================
+    /**
+     * Whether the sink can serve awaited artifact rows: `get` (upsert
+     * read-back), `list` (listing + eviction), and `delete` (`max` cap
+     * eviction) are all required — without `delete` the retention cap
+     * could never evict, so rows fall back to the filesystem store.
+     */
+    get supportsArtifacts() {
+        return (this.definition.get !== undefined &&
+            this.definition.list !== undefined &&
+            this.definition.delete !== undefined);
+    }
+    /** Awaited artifact-row read. Errors propagate (read-after-write). */
+    artifactGet(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const get = this.definition.get;
+            if (get === undefined) {
+                throw new Error("storage get is not configured");
+            }
+            const value = yield get(storageKeys.artifact(this.agentName, id), this.context("restore"));
+            return value !== null && value !== void 0 ? value : undefined;
+        });
+    }
+    /** Awaited artifact-row write (straight to the sink, like author KV). */
+    artifactPut(id, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.definition.put(storageKeys.artifact(this.agentName, id), value, this.context("policy"));
+        });
+    }
+    /** Awaited artifact-row delete. Errors propagate (cap eviction). */
+    artifactDelete(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const del = this.definition.delete;
+            if (del === undefined) {
+                throw new Error("storage delete is not configured");
+            }
+            yield del(storageKeys.artifact(this.agentName, id), this.context("policy"));
+        });
+    }
+    /** All artifact-row values for this agent. Errors propagate. */
+    artifactList() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const list = this.definition.list;
+            if (list === undefined) {
+                throw new Error("storage list is not configured");
+            }
+            const entries = yield list(storageKeys.artifactPrefix(this.agentName), this.context("restore"));
+            return Array.isArray(entries) ? entries.map((entry) => entry.value) : [];
+        });
+    }
+    // ==========================================================================
     // Evals (dedicated `evals` table)
     // ==========================================================================
     /**

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, TurnUsage } from "../types.js";
+import type { SessionEvent, TurnCost, TurnUsage } from "../types.js";
 export interface TrajectoryToolCall {
     callId: string;
     toolName: string;
@@ -32,6 +32,8 @@ 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;
@@ -45,6 +47,8 @@ export interface Trajectory {
     finalText: string;
     turnsFailed: number;
     toolCallCount: number;
+    /** Sum of per-turn estimated costs; present when any turn reported cost. */
+    totalCostUsd?: number;
     turns: TrajectoryTurn[];
 }
 /**
@@ -52,6 +56,10 @@ 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). */
 export declare function parseEventsNdjson(text: string): SessionEvent[];
 /** Load and summarize a durable session event log. */

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,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,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CA4NlE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAc9D;AAED,sDAAsD;AACtD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAuDnE"}
+{"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,CAuOlE;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,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA+DnE"}

package/dist/internal/trajectory.js

@@ -188,6 +188,9 @@ 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 === "") {
@@ -222,9 +225,29 @@ export function buildTrajectory(events) {
         t.toolCalls.length +
         t.subagents.reduce((m, s) => m + s.toolCalls.length, 0), 0);
     const lastGood = [...turns].reverse().find((t) => t.assistantText !== "");
-    return Object.assign(Object.assign(Object.assign(Object.assign({ sessionId }, (sdkAgentId === undefined ? {} : { sdkAgentId })), (agentUrl === undefined ? {} : { agentUrl })), (channelId === undefined ? {} : { channelId })), { ok: turnsFailed === 0 && turns.length > 0, finalText: (_b = lastGood === null || lastGood === void 0 ? void 0 : lastGood.assistantText) !== null && _b !== void 0 ? _b : "", turnsFailed,
-        toolCallCount,
-        turns });
+    const costedTurns = turns.filter((t) => t.cost !== undefined);
+    const totalCostUsd = costedTurns.length === 0
+        ? undefined
+        : roundCostUsd(costedTurns.reduce((sum, t) => { var _a; var _b; return sum + ((_b = (_a = t.cost) === null || _a === void 0 ? void 0 : _a.totalUsd) !== null && _b !== void 0 ? _b : 0); }, 0));
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ sessionId }, (sdkAgentId === undefined ? {} : { sdkAgentId })), (agentUrl === undefined ? {} : { agentUrl })), (channelId === undefined ? {} : { channelId })), { ok: turnsFailed === 0 && turns.length > 0, finalText: (_b = lastGood === null || lastGood === void 0 ? void 0 : lastGood.assistantText) !== null && _b !== void 0 ? _b : "", 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)) {
+        return "—";
+    }
+    if (usd === 0) {
+        return "$0.00";
+    }
+    if (usd >= 0.1) {
+        return `$${usd.toFixed(2)}`;
+    }
+    return `$${usd.toFixed(4)}`;
 }
 /** Parse an `events.ndjson` file (or any NDJSON blob of SessionEvents). */
 export function parseEventsNdjson(text) {
@@ -261,7 +284,9 @@ export function formatTrajectoryText(trajectory) {
     if (trajectory.agentUrl !== undefined) {
         lines.push(`url: ${trajectory.agentUrl}`);
     }
-    lines.push(`turns: ${trajectory.turns.length}  tools=${trajectory.toolCallCount}  failed: ${trajectory.turnsFailed}`);
+    lines.push(`turns: ${trajectory.turns.length}  tools=${trajectory.toolCallCount}  failed: ${trajectory.turnsFailed}${trajectory.totalCostUsd === undefined
+        ? ""
+        : `  est. cost: ${formatCostUsd(trajectory.totalCostUsd)}`}`);
     for (const turn of trajectory.turns) {
         lines.push("");
         lines.push(`── ${turn.turnId}${turn.failed ? " FAILED" : ""} ──`);
@@ -296,7 +321,9 @@ export function formatTrajectoryText(trajectory) {
             lines.push(`  error: ${turn.error}`);
         }
         if (turn.usage !== undefined) {
-            lines.push(`  usage: in ${turn.usage.inputTokens} out ${turn.usage.outputTokens}`);
+            lines.push(`  usage: in ${turn.usage.inputTokens} out ${turn.usage.outputTokens}${turn.cost === undefined
+                ? ""
+                : `  est. cost: ${formatCostUsd(turn.cost.totalUsd)}`}`);
         }
     }
     return `${lines.join("\n")}\n`;