@cursor/july 0.1.30 → 0.1.31

package/dist/internal/session-engine.js

@@ -44,17 +44,18 @@ import { applyCloudUsageToEvents, cloudSdkAgentIdFromEvents, isUnpricedCompleted
 import { isDevMode } from "./dev-mode.js";
 import { EventLogStore } from "./event-log.js";
 import { TurnEventMapper } from "./event-mapper.js";
+import { createHostFilesApi } from "./host-files.js";
 import { createHostKvApi } from "./host-kv.js";
 import { createHostPlatforms, createHostSlackClient, } 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";
 import { StorageCoordinator } from "./storage-coordinator.js";
 import { normalizeToolResult, toolCallErrorMessage } from "./tool-result.js";
+import { estimateTurnCostFromApi, roundCostUsd, } from "./turn-cost.js";
 import { TurnGovernor } from "./turn-governor.js";
 import { buildAgentsMdContent, isNestedInGitRepo, materializeWorkspace, writeWorkspaceFiles, } from "./workspace.js";
 export const HTTP_CHANNEL_ID = "http";
@@ -116,7 +117,7 @@ export class ApprovalInterruptedError extends Error {
 }
 export class SessionEngine {
     constructor(options) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         /** In-flight lazy restores, deduped per channel + continuation key. */
         this.restoreInFlight = new Map();
         this.channelsById = new Map();
@@ -153,11 +154,12 @@ export class SessionEngine {
         this.runner = options.runner;
         this.logger = (_a = options.logger) !== null && _a !== void 0 ? _a : (() => { });
         this.getCloudUsage = (_b = options.getCloudUsage) !== null && _b !== void 0 ? _b : defaultGetCloudUsage;
+        this.estimateTurnCost = (_c = options.estimateTurnCost) !== null && _c !== void 0 ? _c : estimateTurnCostFromApi;
         this.turnGovernor = new TurnGovernor(options.project.agent.concurrency);
         this.sessions = new SessionStore(join(options.stateRoot, "sessions"));
         this.nudgeStore = new SlackNudgeStore(join(options.stateRoot, "slack-nudges"));
         this.askDedupe = new SlackAskDedupeStore(join(options.stateRoot, "slack-asks"));
-        this.logs = new EventLogStore((sessionId) => this.sessions.eventFilePath(sessionId), (sessionId, error) => this.logger(`[agentkit] failed to persist events for ${sessionId}: ${describeError(error)}`));
+        this.logs = new EventLogStore((sessionId) => this.sessions.eventFilePath(sessionId), (sessionId, error) => this.logger(`[agent-sdk] failed to persist events for ${sessionId}: ${describeError(error)}`));
         this.storage =
             options.project.storage === undefined
                 ? undefined
@@ -168,6 +170,10 @@ 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.filesApi = createHostFilesApi({
+            agentName: options.project.name,
+            stateRoot: options.stateRoot,
+        });
         this.artifactsStore = new ArtifactsStore({
             stateRoot: options.stateRoot,
             storage: this.storage,
@@ -180,7 +186,7 @@ export class SessionEngine {
         // resolves them; the host-side MCP registry starts with the concrete
         // connections and gains the rest via setResolvedConnections.
         this.mcpHost = new McpHost(options.project.agent.connections.filter((connection) => !isSymbolicConnectionTransport(connection.transport)));
-        const basePlatforms = (_c = options.platforms) !== null && _c !== void 0 ? _c : createHostPlatforms();
+        const basePlatforms = (_d = options.platforms) !== null && _d !== void 0 ? _d : createHostPlatforms();
         const slackBinding = resolveDedicatedSlackHostBinding(options.project.channels);
         this.platforms =
             slackBinding === undefined
@@ -222,9 +228,22 @@ export class SessionEngine {
             reminders: this.reminderApi,
             evals: this.evalsApi,
             kv: this.kvApi,
+            files: this.filesApi,
             slackNudges: this.slackNudgeHostApi(),
         };
     }
+    /**
+     * Host services with `files` bound to one session, so a relative path in a
+     * tool or hook resolves to that session's scope and can never be read as
+     * another session's. Unbound (no session) keeps `host.files` usable for
+     * `{ scope: "deployment" }` and fails loudly on session-scoped calls.
+     */
+    hostForSession(sessionId) {
+        const host = this.host;
+        return sessionId === undefined
+            ? host
+            : Object.assign(Object.assign({}, host), { files: this.filesApi.forSession(sessionId) });
+    }
     /** Unbound `ctx.artifacts` facade (channel handlers, scratch tool calls). */
     get artifacts() {
         return this.artifactsApi();
@@ -427,7 +446,7 @@ export class SessionEngine {
                     }
                 }
                 catch (error) {
-                    this.logger(`[agentkit] ab "${experiment.name}" enrollment failed (sticky skip): ${describeError(error)}`);
+                    this.logger(`[agent-sdk] ab "${experiment.name}" enrollment failed (sticky skip): ${describeError(error)}`);
                     variant = null;
                 }
                 abs[experiment.name] = variant;
@@ -818,11 +837,11 @@ export class SessionEngine {
                 // that cannot warm resolves cleanly, and logging success there would
                 // tell an operator the workspace is hot when nothing touched it.
                 this.logger(outcome.warmed
-                    ? `[agentkit] warmed ${workspaceDir} in ${Date.now() - startedAt}ms`
-                    : `[agentkit] did not warm ${workspaceDir}: ${outcome.reason}`);
+                    ? `[agent-sdk] warmed ${workspaceDir} in ${Date.now() - startedAt}ms`
+                    : `[agent-sdk] did not warm ${workspaceDir}: ${outcome.reason}`);
             }
             catch (error) {
-                this.logger(`[agentkit] could not warm ${workspaceDir}: ${describeError(error)}`);
+                this.logger(`[agent-sdk] could not warm ${workspaceDir}: ${describeError(error)}`);
             }
         });
     }
@@ -835,7 +854,7 @@ export class SessionEngine {
     }
     executeTurn(record, turnId, message, isFirstTurn, signal) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f;
+            var _a, _b, _c, _d, _e, _f, _g;
             const sessionId = record.sessionId;
             const workspaceDir = this.scaffoldDir(record);
             const harnessCwd = this.harnessCwd(record);
@@ -849,7 +868,7 @@ export class SessionEngine {
                     this.queueDispatch(sessionId, event);
                 }
                 catch (error) {
-                    this.logger(`[agentkit] failed to record event for ${sessionId}: ${describeError(error)}`);
+                    this.logger(`[agent-sdk] failed to record event for ${sessionId}: ${describeError(error)}`);
                 }
             };
             const mapper = new TurnEventMapper(emit);
@@ -933,11 +952,14 @@ 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);
+                : yield this.estimateTurnCost({
+                    model: (_c = this.project.agent.model) !== null && _c !== void 0 ? _c : DEFAULT_MODEL,
+                    usage: finalUsage,
+                    agentId: record.sdkAgentId,
+                    conversationId: (_d = record.sdkAgentId) !== null && _d !== void 0 ? _d : sessionId,
+                });
             if (finalCost !== undefined) {
                 outcome = Object.assign(Object.assign({}, outcome), { cost: finalCost });
             }
@@ -956,21 +978,21 @@ export class SessionEngine {
                     data: {
                         message: interrupted
                             ? "turn interrupted"
-                            : ((_d = outcome.errorMessage) !== null && _d !== void 0 ? _d : (outcome.status === "cancelled"
+                            : ((_e = outcome.errorMessage) !== null && _e !== void 0 ? _e : (outcome.status === "cancelled"
                                 ? "turn cancelled"
                                 : "turn failed")),
                     },
                 });
             }
             const current = yield this.sessions.get(sessionId);
-            const mode = (_e = current === null || current === void 0 ? void 0 : current.mode) !== null && _e !== void 0 ? _e : record.mode;
+            const mode = (_f = current === null || current === void 0 ? void 0 : current.mode) !== null && _f !== void 0 ? _f : record.mode;
             if (mode === "task") {
                 yield this.appendEvent(sessionId, outcome.status === "finished"
                     ? { type: "session.completed", turnId, data: {} }
                     : {
                         type: "session.failed",
                         turnId,
-                        data: { message: (_f = outcome.errorMessage) !== null && _f !== void 0 ? _f : "task failed" },
+                        data: { message: (_g = outcome.errorMessage) !== null && _g !== void 0 ? _g : "task failed" },
                     });
             }
             else {
@@ -1123,7 +1145,7 @@ export class SessionEngine {
                         session: this.sessionInfo(record),
                         workspaceDir: this.harnessCwd(record),
                         stateRoot: this.stateRoot,
-                        host: this.host,
+                        host: this.hostForSession(record.sessionId),
                         artifacts: this.artifactsApi({
                             sessionId: record.sessionId,
                             turnId,
@@ -1381,7 +1403,7 @@ export class SessionEngine {
                     session,
                     workspaceDir,
                     stateRoot: this.stateRoot,
-                    host: this.host,
+                    host: this.hostForSession(record === null || record === void 0 ? void 0 : record.sessionId),
                     // Scratch calls have no real session; their facade stays unbound.
                     artifacts: record === undefined
                         ? this.artifactsApi()
@@ -1453,7 +1475,7 @@ export class SessionEngine {
         const next = chain
             .then(() => this.dispatchEvent(sessionId, event))
             .catch((error) => {
-            this.logger(`[agentkit] event dispatch failed for ${sessionId}: ${describeError(error)}`);
+            this.logger(`[agent-sdk] event dispatch failed for ${sessionId}: ${describeError(error)}`);
         })
             .then(() => {
             var _a;
@@ -1494,7 +1516,7 @@ export class SessionEngine {
                         yield handler(event, channelCtx, sessionCtx);
                     }
                     catch (error) {
-                        this.logger(`[agentkit] channel "${record.channelId}" handler for ${event.type} threw: ${describeError(error)}`);
+                        this.logger(`[agent-sdk] channel "${record.channelId}" handler for ${event.type} threw: ${describeError(error)}`);
                     }
                 }
                 // Handlers mutate channel state in place; persist after each batch.
@@ -1525,7 +1547,7 @@ export class SessionEngine {
                         });
                     }
                     catch (error) {
-                        this.logger(`[agentkit] hook "${hook.name}" handler for ${event.type} threw: ${describeError(error)}`);
+                        this.logger(`[agent-sdk] hook "${hook.name}" handler for ${event.type} threw: ${describeError(error)}`);
                     }
                 }
             }
@@ -1620,7 +1642,7 @@ export class SessionEngine {
                     };
                 }
                 catch (error) {
-                    this.logger(`[agentkit] cursor-hosted session list failed; falling back to local: ${describeError(error)}`);
+                    this.logger(`[agent-sdk] cursor-hosted session list failed; falling back to local: ${describeError(error)}`);
                 }
             }
             const records = yield this.sessions.list();
@@ -1725,7 +1747,7 @@ export class SessionEngine {
     eventStream(sessionId_1) {
         return __awaiter(this, arguments, void 0, function* (sessionId, startIndex = 0) {
             // Playground Trace replays this stream; backfill before the snapshot
-            // so historical Sherlock-style cloud turns can show est. cost.
+            // so historical Sherlock-style cloud turns can show billed cost.
             yield this.backfillCloudTurnCosts(sessionId);
             const log = yield this.logs.get(sessionId);
             return log.stream(startIndex);
@@ -1772,6 +1794,70 @@ export class SessionEngine {
             });
         });
     }
+    /**
+     * Billed/catalog cost for a session. Powers playground, traces, and
+     * `agent-sdk cost` via `GET /v1/session/:id/cost`.
+     */
+    sessionCost(sessionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const record = yield this.getOrRestoreSession(sessionId);
+            if (record === undefined) {
+                throw new Error(`Unknown session: ${sessionId}`);
+            }
+            yield this.backfillCloudTurnCosts(sessionId);
+            const events = yield this.listEvents(sessionId);
+            const sdkAgentId = (_a = (record.sdkAgentId !== undefined && record.sdkAgentId !== ""
+                ? record.sdkAgentId
+                : undefined)) !== null && _a !== void 0 ? _a : cloudSdkAgentIdFromEvents(events);
+            const model = (_b = this.project.agent.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL;
+            const priced = yield this.estimateTurnCost({
+                model,
+                agentId: sdkAgentId,
+                conversationId: sdkAgentId !== null && sdkAgentId !== void 0 ? sdkAgentId : sessionId,
+            });
+            if (priced !== undefined &&
+                (priced.source === "usage" || priced.totalUsd > 0)) {
+                return {
+                    sessionId,
+                    source: priced.source,
+                    cost: {
+                        rawCostCents: (_d = (_c = priced.rawCostCents) !== null && _c !== void 0 ? _c : priced.chargedCents) !== null && _d !== void 0 ? _d : 0,
+                        chargedCents: (_e = priced.chargedCents) !== null && _e !== void 0 ? _e : priced.totalUsd * 100,
+                    },
+                    costUsd: priced.totalUsd,
+                    rawCostUsd: roundCostUsd(((_g = (_f = priced.rawCostCents) !== null && _f !== void 0 ? _f : priced.chargedCents) !== null && _g !== void 0 ? _g : priced.totalUsd * 100) / 100),
+                    model: priced.model,
+                };
+            }
+            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,
+            };
+        });
+    }
     /** Snapshot of recorded events (for download / offline trace). */
     listEvents(sessionId_1) {
         return __awaiter(this, arguments, void 0, function* (sessionId, startIndex = 0, options) {
@@ -1785,7 +1871,7 @@ export class SessionEngine {
     /**
      * 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 est. cost.
+     * before the playground replays the stream so Trace can show cost.
      */
     backfillCloudTurnCosts(sessionId) {
         if (this.cloudCostBackfillDone.has(sessionId)) {
@@ -1797,7 +1883,7 @@ export class SessionEngine {
         }
         const work = this.runCloudTurnCostBackfill(sessionId)
             .catch((error) => {
-            this.logger(`[agentkit] cloud cost backfill failed for ${sessionId}: ${describeError(error)}`);
+            this.logger(`[agent-sdk] cloud cost backfill failed for ${sessionId}: ${describeError(error)}`);
         })
             .finally(() => {
             this.cloudCostBackfill.delete(sessionId);
@@ -1952,7 +2038,7 @@ export class SessionEngine {
                 yield this.runBulkRestore(storage, policy);
             }
             catch (error) {
-                this.logger(`[agentkit] session restore failed: ${describeError(error)}`);
+                this.logger(`[agent-sdk] session restore failed: ${describeError(error)}`);
             }
         });
     }
@@ -1997,7 +2083,7 @@ export class SessionEngine {
                         return { record, events };
                     }
                     catch (error) {
-                        this.logger(`[agentkit] failed to restore session ${record.sessionId}: ${describeError(error)}`);
+                        this.logger(`[agent-sdk] failed to restore session ${record.sessionId}: ${describeError(error)}`);
                         return undefined;
                     }
                 })));
@@ -2012,7 +2098,7 @@ export class SessionEngine {
                     const bytes = Buffer.byteLength(JSON.stringify(item.record), "utf8") +
                         (ndjson === undefined ? 0 : Buffer.byteLength(ndjson, "utf8"));
                     if (bytes > budget) {
-                        this.logger(`[agentkit] session restore stopped at the ${policy.maxTotalBytes}-byte budget after ${restored} session(s); remaining sessions restore lazily on resume`);
+                        this.logger(`[agent-sdk] session restore stopped at the ${policy.maxTotalBytes}-byte budget after ${restored} session(s); remaining sessions restore lazily on resume`);
                         break outer;
                     }
                     try {
@@ -2021,12 +2107,12 @@ export class SessionEngine {
                         restored += 1;
                     }
                     catch (error) {
-                        this.logger(`[agentkit] failed to restore session ${item.record.sessionId}: ${describeError(error)}`);
+                        this.logger(`[agent-sdk] failed to restore session ${item.record.sessionId}: ${describeError(error)}`);
                     }
                 }
             }
             if (restored > 0) {
-                this.logger(`[agentkit] restored ${restored} session(s) from storage`);
+                this.logger(`[agent-sdk] restored ${restored} session(s) from storage`);
             }
         });
     }
@@ -2116,7 +2202,7 @@ export class SessionEngine {
             }
             const events = yield storage.listSessionEvents(record.sessionId);
             yield this.materializeSession(record, eventsNdjson(events));
-            this.logger(`[agentkit] lazily restored session ${record.sessionId} from storage`);
+            this.logger(`[agent-sdk] lazily restored session ${record.sessionId} from storage`);
             return record;
         });
     }
@@ -2194,9 +2280,11 @@ function defaultGetCloudUsage(sdkAgentId) {
             const billed = yield 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/slack-provision-client.js

@@ -248,7 +248,7 @@ function mapErrorResponse(response, bodyText, context) {
     const serverError = body.error;
     switch (response.status) {
         case 401:
-            return new SlackProvisionApiError("The Cursor API key was rejected. Run `agentkit login` again or update CURSOR_API_KEY.", { status: 401 });
+            return new SlackProvisionApiError("The Cursor API key was rejected. Run `agent-sdk login` again or update CURSOR_API_KEY.", { status: 401 });
         case 403:
             return new SlackProvisionApiError(`${serverError !== null && serverError !== void 0 ? serverError : "Not authorized"} — Slack provisioning needs team-admin permission and the cloud-agent entitlement on that team.`, { status: 403 });
         case 404: {

package/dist/internal/storage-coordinator.js

@@ -307,7 +307,7 @@ export class StorageCoordinator {
                 // Index entry without its record (e.g. the record write was shed
                 // under at-most-once). The session is unrecoverable; treat as a miss
                 // so the conversation can continue rather than failing forever.
-                this.logger(`[agentkit] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
+                this.logger(`[agent-sdk] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
                 return undefined;
             }
             // The sink must answer for the exact key it was asked about — a
@@ -454,7 +454,7 @@ export class StorageCoordinator {
                     return Array.isArray(runs) ? runs : [];
                 }
                 catch (error) {
-                    this.logger(`[agentkit] storage evals.list() failed: ${describeError(error)}`);
+                    this.logger(`[agent-sdk] storage evals.list() failed: ${describeError(error)}`);
                     return [];
                 }
             }),
@@ -506,7 +506,7 @@ export class StorageCoordinator {
                 return value !== null && value !== void 0 ? value : undefined;
             }
             catch (error) {
-                this.logger(`[agentkit] storage abs.getSnapshot() failed: ${describeError(error)}`);
+                this.logger(`[agent-sdk] storage abs.getSnapshot() failed: ${describeError(error)}`);
                 return undefined;
             }
         });
@@ -538,7 +538,7 @@ export class StorageCoordinator {
             ]);
             clearTimeout(timer);
             if (!drained) {
-                this.logger(`[agentkit] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
+                this.logger(`[agent-sdk] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
             }
         });
     }
@@ -578,7 +578,7 @@ export class StorageCoordinator {
                 return Array.isArray(entries) ? entries : [];
             }
             catch (error) {
-                this.logger(`[agentkit] storage list(${prefix}) failed: ${describeError(error)}`);
+                this.logger(`[agent-sdk] storage list(${prefix}) failed: ${describeError(error)}`);
                 return [];
             }
         });
@@ -590,7 +590,7 @@ export class StorageCoordinator {
         if (this.pending + ops.length > MAX_PENDING_OPS) {
             this.dropped += ops.length;
             if (this.dropped <= ops.length || this.dropped % 1000 < ops.length) {
-                this.logger(`[agentkit] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
+                this.logger(`[agent-sdk] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
             }
             return;
         }
@@ -602,7 +602,7 @@ export class StorageCoordinator {
                     yield op.run(ctx);
                 }
                 catch (error) {
-                    this.logger(`[agentkit] storage ${op.label} failed: ${describeError(error)}`);
+                    this.logger(`[agent-sdk] storage ${op.label} failed: ${describeError(error)}`);
                 }
                 finally {
                     this.pending -= 1;

package/dist/internal/trajectory.js

@@ -286,7 +286,7 @@ export function formatTrajectoryText(trajectory) {
     }
     lines.push(`turns: ${trajectory.turns.length}  tools=${trajectory.toolCallCount}  failed: ${trajectory.turnsFailed}${trajectory.totalCostUsd === undefined
         ? ""
-        : `  est. cost: ${formatCostUsd(trajectory.totalCostUsd)}`}`);
+        : `  cost: ${formatCostUsd(trajectory.totalCostUsd)}`}`);
     for (const turn of trajectory.turns) {
         lines.push("");
         lines.push(`── ${turn.turnId}${turn.failed ? " FAILED" : ""} ──`);
@@ -323,7 +323,7 @@ export function formatTrajectoryText(trajectory) {
         if (turn.usage !== undefined) {
             lines.push(`  usage: in ${turn.usage.inputTokens} out ${turn.usage.outputTokens}${turn.cost === undefined
                 ? ""
-                : `  est. cost: ${formatCostUsd(turn.cost.totalUsd)}`}`);
+                : `  cost: ${formatCostUsd(turn.cost.totalUsd)}`}`);
         }
     }
     return `${lines.join("\n")}\n`;

package/dist/internal/turn-cost.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Dollar cost for an agent turn, computed by the Cloud Agents
+ * `POST /v1/models/estimate-cost` endpoint (billed usage events when an
+ * agent/conversation id is known, otherwise live catalog pricing).
+ */
+import type { ModelSetting, TurnCost, TurnUsage } from "../types.js";
+export interface UsageCostCents {
+    rawCostCents: number;
+    chargedCents: number;
+}
+export interface EstimateTurnCostInput {
+    model: ModelSetting;
+    usage?: TurnUsage;
+    agentId?: string;
+    conversationId?: string;
+    runId?: string;
+}
+export type EstimateTurnCostFn = (input: EstimateTurnCostInput) => Promise<TurnCost | undefined>;
+export declare function modelSettingId(model: ModelSetting): string;
+export declare function roundCostUsd(usd: number): number;
+export declare function turnCostFromCents(args: {
+    model: string | ModelSetting;
+    cost: UsageCostCents;
+    source: TurnCost["source"];
+}): TurnCost;
+export declare function estimateTurnCostFromApi(input: EstimateTurnCostInput): Promise<TurnCost | undefined>;
+//# sourceMappingURL=turn-cost.d.ts.map

package/dist/internal/turn-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-cost.d.ts","sourceRoot":"","sources":["../../src/internal/turn-cost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGrE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;AAEnC,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE1D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC5B,GAAG,QAAQ,CAeX;AAQD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CA8C/B"}

package/dist/internal/turn-cost.js

@@ -0,0 +1,83 @@
+/**
+ * Dollar cost for an agent turn, computed by the Cloud Agents
+ * `POST /v1/models/estimate-cost` endpoint (billed usage events when an
+ * agent/conversation id is known, otherwise live catalog pricing).
+ */
+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 { cursorExternalApiUrl, resolveApiKey } from "./cursor/credentials.js";
+export function modelSettingId(model) {
+    return typeof model === "string" ? model : model.id;
+}
+export function roundCostUsd(usd) {
+    return Math.round(usd * 1e6) / 1e6;
+}
+export function turnCostFromCents(args) {
+    const totalUsd = roundCostUsd(args.cost.chargedCents / 100);
+    const model = typeof args.model === "string" ? args.model : modelSettingId(args.model);
+    return {
+        totalUsd,
+        inputUsd: 0,
+        outputUsd: 0,
+        cacheReadUsd: 0,
+        cacheWriteUsd: 0,
+        model,
+        source: args.source,
+        rawCostCents: args.cost.rawCostCents,
+        chargedCents: args.cost.chargedCents,
+    };
+}
+export function estimateTurnCostFromApi(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        var _f;
+        const resolved = yield resolveApiKey();
+        if (resolved === undefined) {
+            return undefined;
+        }
+        const model = modelSettingId(input.model);
+        const response = yield fetch(`${cursorExternalApiUrl()}/v1/models/estimate-cost`, {
+            method: "POST",
+            headers: {
+                authorization: `Bearer ${resolved.apiKey}`,
+                "content-type": "application/json",
+            },
+            body: JSON.stringify({
+                model,
+                inputTokens: (_a = input.usage) === null || _a === void 0 ? void 0 : _a.inputTokens,
+                outputTokens: (_b = input.usage) === null || _b === void 0 ? void 0 : _b.outputTokens,
+                cacheReadTokens: (_c = input.usage) === null || _c === void 0 ? void 0 : _c.cacheReadTokens,
+                cacheWriteTokens: (_d = input.usage) === null || _d === void 0 ? void 0 : _d.cacheWriteTokens,
+                agentId: input.agentId,
+                conversationId: input.conversationId,
+                runId: input.runId,
+            }),
+        });
+        if (!response.ok) {
+            return undefined;
+        }
+        let body;
+        try {
+            body = (yield response.json());
+        }
+        catch (_g) {
+            return undefined;
+        }
+        if (typeof ((_e = body.cost) === null || _e === void 0 ? void 0 : _e.rawCostCents) !== "number" ||
+            typeof body.cost.chargedCents !== "number") {
+            return undefined;
+        }
+        return turnCostFromCents({
+            model: (_f = body.model) !== null && _f !== void 0 ? _f : model,
+            cost: body.cost,
+            source: body.source === "usage" ? "usage" : "catalog",
+        });
+    });
+}

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

@@ -1,5 +1,5 @@
 /**
- * Outdated-version warning + `agentkit update`.
+ * Outdated-version warning + `agent-sdk update`.
  *
  * Every CLI run of a published install compares its own version against the
  * npm registry's `latest` dist-tag and warns on stderr when behind. The
@@ -8,7 +8,7 @@
  * network; a stale cache refreshes inline under a short timeout, and any
  * network failure is silent (the warning is best-effort, never a blocker).
  *
- * `agentkit update` re-runs the lookup fresh, figures out how this copy was
+ * `agent-sdk update` re-runs the lookup fresh, figures out how this copy was
  * installed (global npm/pnpm/yarn/bun, or a project dependency), and runs the
  * matching install command.
  */
@@ -87,7 +87,7 @@ export interface UpdateCliOptions {
     out?: (text: string) => void;
     err?: (text: string) => void;
 }
-/** `agentkit update` — upgrade this install to the latest published version. */
+/** `agent-sdk update` — upgrade this install to the latest published version. */
 export declare function cmdUpdate(options?: UpdateCliOptions): Promise<number>;
 export {};
 //# sourceMappingURL=update-check.d.ts.map

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

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