@cursor/july 0.1.25 → 0.1.27

package/dist/internal/cli-slack.js

@@ -356,6 +356,15 @@ function prepareProvision(options) {
         };
     });
 }
+/**
+ * Slack's team-scoped admin page listing pending app-install requests.
+ * Provisioned apps have no OAuth flow (no redirect URLs, install-from-Slack
+ * disabled), so the oauth_authorize_url Slack returns from
+ * apps.manifest.create dead-ends; approval happens here instead.
+ */
+function slackAppRequestsUrl(slackTeamId) {
+    return `https://app.slack.com/apps-manage/${encodeURIComponent(slackTeamId)}/integrations/requests`;
+}
 /** "Name (T0123ABCD)", or the bare id when the backend has no name. */
 function formatWorkspace(workspace) {
     var _a;
@@ -432,7 +441,7 @@ function runConnectFlow(ctx, wait) {
 }
 export function cmdSlackCreate(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
+        var _a;
         const target = resolveSlackAppTarget(options, errStream(options));
         if (typeof target === "number") {
             return target;
@@ -553,6 +562,7 @@ export function cmdSlackCreate(options) {
         }
         const iconStatus = yield applySlackCreateIcon(ctx, iconSource, result);
         if (result.status === "pending_admin_approval") {
+            const approveUrl = slackAppRequestsUrl(workspace.slackTeamId);
             if (ctx.json) {
                 ctx.out(`${JSON.stringify({
                     ok: false,
@@ -561,15 +571,13 @@ export function cmdSlackCreate(options) {
                     slackTeamId: workspace.slackTeamId,
                     envKeys: target.envKeys,
                     wrote,
-                    oauthAuthorizeUrl: (_a = result.oauthAuthorizeUrl) !== null && _a !== void 0 ? _a : null,
+                    approveUrl,
                     iconStatus,
                 }, null, 2)}\n`);
             }
             else {
                 ctx.err(`The Slack app was created (app ${result.appId}), but installing it needs a Slack workspace-admin approval.\n` +
-                    (result.oauthAuthorizeUrl === undefined
-                        ? ""
-                        : `\n  Approve it (or send this to a workspace admin):\n\n    ${result.oauthAuthorizeUrl}\n\n`) +
+                    `\n  A workspace admin can approve it here:\n\n    ${approveUrl}\n\n` +
                     `Once an admin approves the app, re-run \`${CLI} slack create\` to finish the install and mint the tokens.\n`);
             }
             return 1;
@@ -611,7 +619,7 @@ export function cmdSlackCreate(options) {
         }
         ctx.out(`Provisioned the ${target.env} Slack app for ${target.slug} (app ${result.appId}) in workspace ${workspace.slackTeamId}.\n` +
             `  wrote ${envEntries.map((entry) => entry.key).join(" + ")} to ${envFile}\n\n`);
-        const doctor = (_b = options.doctorImpl) !== null && _b !== void 0 ? _b : runSlackDoctor;
+        const doctor = (_a = options.doctorImpl) !== null && _a !== void 0 ? _a : runSlackDoctor;
         const doctorResult = yield doctor(target.envPrefix === undefined ? {} : { envPrefix: target.envPrefix });
         ctx.out(renderDoctorReport(doctorResult));
         ctx.out(`\nNext steps:\n` +

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

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAQrB,KAAK,UAAU,EAqBhB,MAAM,aAAa,CAAC;AAsBrB,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAmBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAoBzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAIrC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA8DvB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AAuoBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E;AAwoBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAoInE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EASrB,KAAK,UAAU,EAqBhB,MAAM,aAAa,CAAC;AA0BrB,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAmBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAoBzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAIrC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAiEvB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AA+oBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E;AAmtBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CA4InE"}

package/dist/internal/discovery.js

@@ -29,12 +29,13 @@ import { readdir, readFile, stat } from "node:fs/promises";
 import { basename, extname, isAbsolute, join, relative, resolve, } from "node:path";
 import { pathToFileURL } from "node:url";
 import { resolveABMaxPlaygroundSessions } from "../ab.js";
+import { resolveArtifactsMax } from "../artifacts.js";
 import { httpChannel } from "../channels.js";
 import { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, MAX_RUNNING_TURNS_LIMIT, normalizeCursorAccountServers, toPublicCloudInfo, } from "../types.js";
 import { registerAuthoredModuleLoaders } from "./authored-loaders.js";
 import { normalizePositiveInt } from "./bounded-int.js";
 import { getDefinitionKind } from "./brand.js";
-import { builtinTools } from "./builtin-tools/index.js";
+import { artifactBuiltinTool, builtinTools, TAG_ARTIFACT_TOOL_NAME, } from "./builtin-tools/index.js";
 import { isValidCron } from "./cron.js";
 import { parseFrontmatter } from "./frontmatter.js";
 import { isReservedSecretName, MAX_EGRESS_DOMAINS, validateEgressDomain, validateSecretName, } from "./hosting.js";
@@ -203,6 +204,8 @@ export function loadAgentProject(dir_1) {
         const abs = yield loadABs(ctx, agentDir);
         const abConfig = yield loadABConfig(ctx, agentDir);
         const storage = yield loadStorage(ctx, agentDir);
+        const artifacts = yield loadArtifacts(ctx, agentDir);
+        yield appendArtifactTool(ctx, agentDir, agent, artifacts);
         if (agentDir !== rootDir) {
             yield warnUnknownSlots(ctx, agentDir);
         }
@@ -218,6 +221,7 @@ export function loadAgentProject(dir_1) {
             abs,
             abConfig,
             storage,
+            artifacts,
             diagnostics,
         };
     });
@@ -261,6 +265,14 @@ function loadAgent(ctx, agentDir, options) {
                     message: "builtinTools is not supported on subagents; ignoring.",
                 });
             }
+            const artifactsPath = yield findModuleFile(agentDir, "artifacts");
+            if (artifactsPath !== undefined) {
+                ctx.diagnostics.push({
+                    severity: "warning",
+                    path: displayPath(ctx, artifactsPath),
+                    message: "artifacts are not supported on subagents; ignoring.",
+                });
+            }
             return Object.assign(Object.assign(Object.assign(Object.assign({ name }, ((config === null || config === void 0 ? void 0 : config.description) === undefined
                 ? {}
                 : { description: config.description })), ((config === null || config === void 0 ? void 0 : config.model) === undefined ? {} : { model: config.model })), (instructions === undefined ? {} : { instructions })), { runtime: "local", tools: [], skills: [], connections: [], subagents: [], seedFiles: [] });
@@ -1297,6 +1309,68 @@ function loadStorage(ctx, agentDir) {
         return definition;
     });
 }
+// ============================================================================
+// Artifacts (agent/artifacts.ts)
+// ============================================================================
+function loadArtifacts(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const path = yield findModuleFile(agentDir, "artifacts");
+        if (path === undefined) {
+            return undefined;
+        }
+        const imported = yield importDefault(ctx, path, "artifacts");
+        if (imported === undefined) {
+            return undefined;
+        }
+        const definition = imported;
+        if (definition.agentTool === true &&
+            Object.keys((_a = definition.kinds) !== null && _a !== void 0 ? _a : {}).length === 0) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, path),
+                message: "artifacts.agentTool requires kinds: the tag_artifact tool needs at least one declared kind; its descriptions are the tool prompt.",
+            });
+        }
+        return definition;
+    });
+}
+/**
+ * Materialize the `tag_artifact` built-in when `defineArtifacts` set
+ * `agentTool: true`. Appended after `loadAgent` because the tool is
+ * generated from the artifacts kinds registry, not `AgentConfig.builtinTools`.
+ */
+function appendArtifactTool(ctx, agentDir, agent, artifacts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const tool = artifactBuiltinTool(artifacts);
+        if (tool === undefined) {
+            return;
+        }
+        const artifactsPath = displayPath(ctx, (_a = (yield findModuleFile(agentDir, "artifacts"))) !== null && _a !== void 0 ? _a : join(agentDir, "artifacts.ts"));
+        // TODO(artifacts-cloud): on cloud runtimes, ship tag_artifact as an
+        // execution: "agent" script and have the host fold its action.result
+        // stream events into artifact records — agent-tool calls already surface
+        // durably in the session stream.
+        if (agent.runtime === "cloud") {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: artifactsPath,
+                message: "tag_artifact is an in-process server tool (like builtinTools) and is not available on cloud agents; it is skipped.",
+            });
+            return;
+        }
+        if (agent.tools.some((t) => t.name === TAG_ARTIFACT_TOOL_NAME)) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: artifactsPath,
+                message: `Authored tool "${TAG_ARTIFACT_TOOL_NAME}" shadows the built-in tool of the same name; the authored tool wins.`,
+            });
+            return;
+        }
+        agent.tools.push(tool);
+    });
+}
 function resolveABName(definition, fallback) {
     if (typeof definition === "object" &&
         definition !== null &&
@@ -1341,6 +1415,7 @@ function loadSeedFiles(ctx, agentDir) {
 // ============================================================================
 export function projectInfo(project) {
     var _a, _b, _c, _d;
+    var _e;
     const agent = project.agent;
     const httpRoutes = [
         { method: "POST", path: "/v1/session", url: "/v1/session" },
@@ -1444,7 +1519,13 @@ export function projectInfo(project) {
             },
         })), { storage: project.storage === undefined
             ? undefined
-            : { name: project.storage.name }, diagnostics: project.diagnostics });
+            : { name: project.storage.name }, artifacts: project.artifacts === undefined
+            ? undefined
+            : {
+                kinds: Object.keys((_e = project.artifacts.kinds) !== null && _e !== void 0 ? _e : {}),
+                agentTool: project.artifacts.agentTool === true,
+                max: resolveArtifactsMax(project.artifacts),
+            }, diagnostics: project.diagnostics });
 }
 // ============================================================================
 // Shared helpers

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

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAsBzC,CAAC"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAuBzC,CAAC"}

package/dist/internal/distribution.js

@@ -91,6 +91,7 @@ export const AUTHORING_ENTRY_FILES = [
     ["evals/reporters", "evals/reporters.js"],
     ["evals/loaders", "evals/loaders.js"],
     ["ab", "ab.js"],
+    ["artifacts", "artifacts.js"],
     ["storage", "storage.js"],
     ["storage/file-kv", "storage-backends/file-kv.js"],
     ["storage/postgres-kv", "storage-backends/postgres-kv.js"],

package/dist/internal/model-pricing.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Best-effort dollar-cost estimation for agent turns.
+ *
+ * The Cursor harness streams token usage (`turn-ended`) but no dollar cost,
+ * and server-billed cost is only queryable for cloud agents — so the
+ * framework prices token usage against a built-in snapshot of Cursor's
+ * published per-model API rates. Estimates are marked `source: "estimate"`
+ * everywhere they surface (traces, playground, A/B metrics, CLI); the billed
+ * amount on the Cursor dashboard remains the source of truth.
+ *
+ * Unknown models produce no estimate rather than a wrong one. Deployments
+ * can extend or correct the table without a package upgrade via the
+ * `AGENT_SERVE_MODEL_PRICING` environment variable (a JSON object merged
+ * over the defaults, keyed by model id).
+ */
+import type { ModelSetting, TurnCost, TurnUsage } from "../types.js";
+/** USD per million tokens for one pricing tier. */
+export interface ModelPricingTier {
+    inputUsdPerMTok: number;
+    outputUsdPerMTok: number;
+    cacheReadUsdPerMTok: number;
+    /** Defaults to {@link inputUsdPerMTok} when omitted (provider convention). */
+    cacheWriteUsdPerMTok?: number;
+}
+export interface ModelPricing extends ModelPricingTier {
+    /** Rates when the model's `fast` parameter is `"true"`. */
+    fast?: ModelPricingTier;
+}
+/**
+ * Snapshot of Cursor API per-model token rates (USD per million tokens).
+ * Keyed by normalized model id; family aliases (`sonnet`, `gpt`, …) point at
+ * the model they currently resolve to.
+ */
+export declare const DEFAULT_MODEL_PRICING: Readonly<Record<string, ModelPricing>>;
+/** Env var holding a JSON pricing override merged over the defaults. */
+export declare const MODEL_PRICING_ENV_VAR = "AGENT_SERVE_MODEL_PRICING";
+export declare function normalizeModelId(id: string): string;
+/**
+ * Rates for a model selection, honoring its `fast` parameter. `undefined`
+ * when the model is not in the table (no estimate is better than a wrong
+ * one).
+ */
+export declare function resolveModelPricing(model: ModelSetting): ModelPricingTier | undefined;
+/**
+ * Estimate the dollar cost of one turn's token usage. `undefined` when the
+ * model has no known rates.
+ */
+export declare function estimateTurnCost(model: ModelSetting, usage: TurnUsage): TurnCost | undefined;
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/internal/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/internal/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErE,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,2DAA2D;IAC3D,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAID;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAgNxE,CAAC;AAkCF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAoEjE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAiBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,GAClB,gBAAgB,GAAG,SAAS,CAgB9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,SAAS,GACf,QAAQ,GAAG,SAAS,CAmBtB"}

package/dist/internal/model-pricing.js

@@ -0,0 +1,377 @@
+/**
+ * Best-effort dollar-cost estimation for agent turns.
+ *
+ * The Cursor harness streams token usage (`turn-ended`) but no dollar cost,
+ * and server-billed cost is only queryable for cloud agents — so the
+ * framework prices token usage against a built-in snapshot of Cursor's
+ * published per-model API rates. Estimates are marked `source: "estimate"`
+ * everywhere they surface (traces, playground, A/B metrics, CLI); the billed
+ * amount on the Cursor dashboard remains the source of truth.
+ *
+ * Unknown models produce no estimate rather than a wrong one. Deployments
+ * can extend or correct the table without a package upgrade via the
+ * `AGENT_SERVE_MODEL_PRICING` environment variable (a JSON object merged
+ * over the defaults, keyed by model id).
+ */
+const M = 1000000;
+/**
+ * Snapshot of Cursor API per-model token rates (USD per million tokens).
+ * Keyed by normalized model id; family aliases (`sonnet`, `gpt`, …) point at
+ * the model they currently resolve to.
+ */
+export const DEFAULT_MODEL_PRICING = {
+    // xAI / Cursor-served Grok
+    "grok-4.5": {
+        inputUsdPerMTok: 2,
+        outputUsdPerMTok: 6,
+        cacheReadUsdPerMTok: 0.5,
+        fast: { inputUsdPerMTok: 4, outputUsdPerMTok: 18, cacheReadUsdPerMTok: 1 },
+    },
+    "grok-4.20": {
+        inputUsdPerMTok: 2,
+        outputUsdPerMTok: 6,
+        cacheReadUsdPerMTok: 0.2,
+    },
+    "grok-4.3": {
+        inputUsdPerMTok: 1.25,
+        outputUsdPerMTok: 2.5,
+        cacheReadUsdPerMTok: 0.125,
+    },
+    "grok-code": {
+        inputUsdPerMTok: 0.2,
+        outputUsdPerMTok: 1.5,
+        cacheReadUsdPerMTok: 0.02,
+    },
+    // Anthropic
+    "opus-5": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 25,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+        fast: {
+            inputUsdPerMTok: 10,
+            outputUsdPerMTok: 50,
+            cacheReadUsdPerMTok: 1,
+            cacheWriteUsdPerMTok: 12.5,
+        },
+    },
+    "opus-4.8": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 25,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+        fast: {
+            inputUsdPerMTok: 10,
+            outputUsdPerMTok: 50,
+            cacheReadUsdPerMTok: 1,
+            cacheWriteUsdPerMTok: 12.5,
+        },
+    },
+    "opus-4.7": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 25,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+        fast: {
+            inputUsdPerMTok: 30,
+            outputUsdPerMTok: 150,
+            cacheReadUsdPerMTok: 3,
+            cacheWriteUsdPerMTok: 37.5,
+        },
+    },
+    "opus-4.6": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 25,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+    },
+    "opus-4.5": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 25,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+    },
+    "sonnet-5": {
+        inputUsdPerMTok: 3,
+        outputUsdPerMTok: 15,
+        cacheReadUsdPerMTok: 0.3,
+        cacheWriteUsdPerMTok: 3.75,
+    },
+    "sonnet-4.6": {
+        inputUsdPerMTok: 3,
+        outputUsdPerMTok: 15,
+        cacheReadUsdPerMTok: 0.3,
+        cacheWriteUsdPerMTok: 3.75,
+    },
+    "sonnet-4.5": {
+        inputUsdPerMTok: 3,
+        outputUsdPerMTok: 15,
+        cacheReadUsdPerMTok: 0.3,
+        cacheWriteUsdPerMTok: 3.75,
+    },
+    "haiku-4.5": {
+        inputUsdPerMTok: 1,
+        outputUsdPerMTok: 5,
+        cacheReadUsdPerMTok: 0.1,
+        cacheWriteUsdPerMTok: 1.25,
+    },
+    "fable-5": {
+        inputUsdPerMTok: 10,
+        outputUsdPerMTok: 50,
+        cacheReadUsdPerMTok: 1,
+        cacheWriteUsdPerMTok: 12.5,
+    },
+    // OpenAI
+    "gpt-5.6": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 30,
+        cacheReadUsdPerMTok: 0.5,
+        cacheWriteUsdPerMTok: 6.25,
+        fast: {
+            inputUsdPerMTok: 10,
+            outputUsdPerMTok: 60,
+            cacheReadUsdPerMTok: 1,
+            cacheWriteUsdPerMTok: 12.5,
+        },
+    },
+    "gpt-5.5": {
+        inputUsdPerMTok: 5,
+        outputUsdPerMTok: 30,
+        cacheReadUsdPerMTok: 0.5,
+    },
+    "gpt-5.4": {
+        inputUsdPerMTok: 2.5,
+        outputUsdPerMTok: 15,
+        cacheReadUsdPerMTok: 0.25,
+    },
+    "gpt-5.2": {
+        inputUsdPerMTok: 1.75,
+        outputUsdPerMTok: 14,
+        cacheReadUsdPerMTok: 0.175,
+    },
+    "gpt-mini": {
+        inputUsdPerMTok: 0.75,
+        outputUsdPerMTok: 4.5,
+        cacheReadUsdPerMTok: 0.075,
+    },
+    "codex-5.3": {
+        inputUsdPerMTok: 1.75,
+        outputUsdPerMTok: 14,
+        cacheReadUsdPerMTok: 0.175,
+    },
+    "codex-5.2": {
+        inputUsdPerMTok: 1.75,
+        outputUsdPerMTok: 14,
+        cacheReadUsdPerMTok: 0.175,
+    },
+    // Google
+    "gemini-3.1-pro": {
+        inputUsdPerMTok: 2,
+        outputUsdPerMTok: 12,
+        cacheReadUsdPerMTok: 0.2,
+    },
+    "gemini-3-pro": {
+        inputUsdPerMTok: 2,
+        outputUsdPerMTok: 12,
+        cacheReadUsdPerMTok: 0.2,
+    },
+    "gemini-3.6-flash": {
+        inputUsdPerMTok: 1.5,
+        outputUsdPerMTok: 7.5,
+        cacheReadUsdPerMTok: 0.15,
+    },
+    "gemini-3.5-flash": {
+        inputUsdPerMTok: 1.5,
+        outputUsdPerMTok: 9,
+        cacheReadUsdPerMTok: 0.15,
+    },
+    // Cursor Composer
+    "composer-2.5": {
+        inputUsdPerMTok: 0.5,
+        outputUsdPerMTok: 2.5,
+        cacheReadUsdPerMTok: 0.2,
+        fast: {
+            inputUsdPerMTok: 3,
+            outputUsdPerMTok: 15,
+            cacheReadUsdPerMTok: 0.5,
+        },
+    },
+    "composer-2": {
+        inputUsdPerMTok: 0.5,
+        outputUsdPerMTok: 2.5,
+        cacheReadUsdPerMTok: 0.2,
+    },
+    // Moonshot / Zhipu
+    "kimi-k3": {
+        inputUsdPerMTok: 3,
+        outputUsdPerMTok: 15,
+        cacheReadUsdPerMTok: 0.3,
+    },
+    "kimi-k2.7": {
+        inputUsdPerMTok: 0.95,
+        outputUsdPerMTok: 4,
+        cacheReadUsdPerMTok: 0.19,
+    },
+    "kimi-k2.5": {
+        inputUsdPerMTok: 0.6,
+        outputUsdPerMTok: 3,
+        cacheReadUsdPerMTok: 0.1,
+    },
+    "glm-5.2": {
+        inputUsdPerMTok: 1.4,
+        outputUsdPerMTok: 4.4,
+        cacheReadUsdPerMTok: 0.26,
+    },
+};
+/** Family aliases → the model id they currently resolve to. */
+const MODEL_ID_ALIASES = {
+    grok: "grok-4.20",
+    "grok-latest": "grok-4.3",
+    "grok-code-latest": "grok-code",
+    opus: "opus-5",
+    "opus-latest": "opus-5",
+    sonnet: "sonnet-4.6",
+    "sonnet-latest": "sonnet-5",
+    haiku: "haiku-4.5",
+    "haiku-latest": "haiku-4.5",
+    fable: "fable-5",
+    gpt: "gpt-5.6",
+    "gpt-latest": "gpt-5.6",
+    "gpt-5-6-sol": "gpt-5.6",
+    "gpt-5-5": "gpt-5.5",
+    "gpt-mini-latest": "gpt-mini",
+    codex: "codex-5.3",
+    "codex-latest": "codex-5.3",
+    gemini: "gemini-3.1-pro",
+    "gemini-latest": "gemini-3.1-pro",
+    "gemini-pro": "gemini-3.1-pro",
+    "gemini-pro-latest": "gemini-3.1-pro",
+    "gemini-flash": "gemini-3.6-flash",
+    "gemini-flash-latest": "gemini-3.6-flash",
+    composer: "composer-2.5",
+    "composer-latest": "composer-2.5",
+    "composer-2-5": "composer-2.5",
+    kimi: "kimi-k2.7",
+    "kimi-latest": "kimi-k2.7",
+};
+/** Env var holding a JSON pricing override merged over the defaults. */
+export const MODEL_PRICING_ENV_VAR = "AGENT_SERVE_MODEL_PRICING";
+let cachedEnvOverride;
+function envOverrideTable() {
+    const raw = process.env[MODEL_PRICING_ENV_VAR];
+    if (cachedEnvOverride !== undefined && cachedEnvOverride.raw === raw) {
+        return cachedEnvOverride.table;
+    }
+    let table = {};
+    if (raw !== undefined && raw.trim() !== "") {
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === "object" && parsed !== null) {
+                for (const [key, value] of Object.entries(parsed)) {
+                    const tier = parsePricing(value);
+                    if (tier !== undefined) {
+                        table[normalizeModelId(key)] = tier;
+                    }
+                }
+            }
+        }
+        catch (_a) {
+            table = {};
+        }
+    }
+    cachedEnvOverride = { raw, table };
+    return table;
+}
+function parseTier(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const row = value;
+    const input = row.inputUsdPerMTok;
+    const output = row.outputUsdPerMTok;
+    const cacheRead = row.cacheReadUsdPerMTok;
+    if (!isRate(input) ||
+        !isRate(output) ||
+        (cacheRead !== undefined && !isRate(cacheRead))) {
+        return undefined;
+    }
+    const cacheWrite = row.cacheWriteUsdPerMTok;
+    return {
+        inputUsdPerMTok: input,
+        outputUsdPerMTok: output,
+        cacheReadUsdPerMTok: isRate(cacheRead) ? cacheRead : input,
+        cacheWriteUsdPerMTok: isRate(cacheWrite) ? cacheWrite : undefined,
+    };
+}
+function parsePricing(value) {
+    const base = parseTier(value);
+    if (base === undefined) {
+        return undefined;
+    }
+    const fast = parseTier(value.fast);
+    return Object.assign(Object.assign({}, base), { fast });
+}
+function isRate(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+export function normalizeModelId(id) {
+    return id.trim().toLowerCase();
+}
+function modelId(model) {
+    return typeof model === "string" ? model : model.id;
+}
+function modelHasFastParam(model) {
+    var _a;
+    if (typeof model === "string") {
+        return false;
+    }
+    return (((_a = model.params) === null || _a === void 0 ? void 0 : _a.some((param) => param.id === "fast" && param.value === "true")) === true);
+}
+/**
+ * Rates for a model selection, honoring its `fast` parameter. `undefined`
+ * when the model is not in the table (no estimate is better than a wrong
+ * one).
+ */
+export function resolveModelPricing(model) {
+    var _a, _b, _c, _d;
+    const overrides = envOverrideTable();
+    const rawId = normalizeModelId(modelId(model));
+    const canonicalId = (_a = MODEL_ID_ALIASES[rawId]) !== null && _a !== void 0 ? _a : rawId;
+    const pricing = (_d = (_c = (_b = overrides[rawId]) !== null && _b !== void 0 ? _b : overrides[canonicalId]) !== null && _c !== void 0 ? _c : DEFAULT_MODEL_PRICING[rawId]) !== null && _d !== void 0 ? _d : DEFAULT_MODEL_PRICING[canonicalId];
+    if (pricing === undefined) {
+        return undefined;
+    }
+    if (modelHasFastParam(model) && pricing.fast !== undefined) {
+        return pricing.fast;
+    }
+    return pricing;
+}
+/**
+ * Estimate the dollar cost of one turn's token usage. `undefined` when the
+ * model has no known rates.
+ */
+export function estimateTurnCost(model, usage) {
+    var _a;
+    const tier = resolveModelPricing(model);
+    if (tier === undefined) {
+        return undefined;
+    }
+    const cacheWriteRate = (_a = tier.cacheWriteUsdPerMTok) !== null && _a !== void 0 ? _a : tier.inputUsdPerMTok;
+    const inputUsd = (usage.inputTokens / M) * tier.inputUsdPerMTok;
+    const outputUsd = (usage.outputTokens / M) * tier.outputUsdPerMTok;
+    const cacheReadUsd = (usage.cacheReadTokens / M) * tier.cacheReadUsdPerMTok;
+    const cacheWriteUsd = (usage.cacheWriteTokens / M) * cacheWriteRate;
+    return {
+        totalUsd: roundUsd(inputUsd + outputUsd + cacheReadUsd + cacheWriteUsd),
+        inputUsd: roundUsd(inputUsd),
+        outputUsd: roundUsd(outputUsd),
+        cacheReadUsd: roundUsd(cacheReadUsd),
+        cacheWriteUsd: roundUsd(cacheWriteUsd),
+        model: normalizeModelId(modelId(model)),
+        source: "estimate",
+    };
+}
+/** Keep persisted estimates readable: micro-dollar precision. */
+function roundUsd(usd) {
+    return Math.round(usd * 1e6) / 1e6;
+}

package/dist/internal/reminder-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA6BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED;;;;;OAKG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YA6GJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA6BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED;;;;;OAKG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YA6GJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IA0DxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal/reminder-runner.js

@@ -539,6 +539,7 @@ export class ReminderRunner {
             host: this.engine.host,
             mcp: this.engine.host.mcp,
             appAuth: APP_AUTH,
+            artifacts: this.engine.artifacts,
             followup(args) {
                 return __awaiter(this, void 0, void 0, function* () {
                     const auth = yield self.resolveFollowupAuth(record.channelId, record.continuationToken);