@cursor/july 0.1.26 → 0.1.28

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
@@ -1566,7 +1647,14 @@ function isModuleFile(fileName) {
     if (fileName.endsWith(".d.ts") || fileName.startsWith(".")) {
         return false;
     }
-    return MODULE_EXTENSIONS.has(extname(fileName));
+    if (!MODULE_EXTENSIONS.has(extname(fileName))) {
+        return false;
+    }
+    // Colocated unit tests (Vitest/Jest convention) are not definitions.
+    // Without this, `channels/slack.test.ts` is scanned as a channel named
+    // "slack.test", fails NAME_PATTERN, and the whole agent refuses to serve.
+    const stem = moduleStem(fileName);
+    return !stem.endsWith(".test") && !stem.endsWith(".spec");
 }
 function moduleStem(fileName) {
     return fileName.slice(0, -extname(fileName).length);

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);

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

@@ -1 +1 @@
-{"version":3,"file":"schedule-runner.d.ts","sourceRoot":"","sources":["../../src/internal/schedule-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,QAAQ,EAAE,WAItB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAQD,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,eAAe,CAAM;IAE7B,YACmB,MAAM,EAAE,aAAa,EACtC,OAAO,EAAE,YAAY,EACJ,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAO3D;IAED,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,IAAI;IAoBZ,2EAA2E;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAuDpE;CACF"}
+{"version":3,"file":"schedule-runner.d.ts","sourceRoot":"","sources":["../../src/internal/schedule-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,QAAQ,EAAE,WAItB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAQD,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,eAAe,CAAM;IAE7B,YACmB,MAAM,EAAE,aAAa,EACtC,OAAO,EAAE,YAAY,EACJ,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAO3D;IAED,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,IAAI;IAoBZ,2EAA2E;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAwDpE;CACF"}

package/dist/internal/schedule-runner.js

@@ -115,6 +115,7 @@ export class ScheduleRunner {
                 },
                 appAuth: APP_AUTH,
                 host: this.engine.host,
+                artifacts: this.engine.artifacts,
             });
             // Collect ids from receive() calls the handler chose not to await
             // (commonly wrapped in waitUntil); receive resolves at message accept,

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

@@ -1 +1 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACf,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,qBAAa,eAAgB,YAAW,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC9D;YAEa,cAAc;IAyE5B;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAepE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;IAED,OAAO,CAAC,QAAQ;IA0BhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;YACW,iBAAiB;YAkBjB,SAAS;YAOT,cAAc;YA6Bd,cAAc;IAqC5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE;AAmED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACf,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,qBAAa,eAAgB,YAAW,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC9D;YAEa,cAAc;IAyE5B;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAepE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;IAED,OAAO,CAAC,QAAQ;IA0BhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;YACW,iBAAiB;YAkBjB,SAAS;YAOT,cAAc;YA6Bd,cAAc;IA6C5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE;AAmED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}

package/dist/internal/sdk-runner.js

@@ -310,7 +310,15 @@ export class CursorSdkRunner {
             if (request.isFirstTurn) {
                 return Agent.create(options);
             }
-            throw new Error(`Cloud session ${request.sessionId} is missing sdkAgentId; cannot resume.`);
+            // A cloud session past its first turn should carry the bound agent id
+            // (the engine persists it via onSdkAgentId as soon as create() reports
+            // one). Reaching here means the binding turn failed before the server
+            // ever minted an agent — e.g. create() rejected its PR attach — so the
+            // session would otherwise fail every future turn. Mirror the local
+            // host-replacement path above: a fresh conversation beats failing this
+            // thread forever, and the new id binds to the session for later resumes.
+            this.log(`[agentkit] cloud session ${request.sessionId} has no bound cloud agent; creating a fresh one`);
+            return Agent.create(options);
         });
     }
     getStore(stateDir) {

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA2pB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAiBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA4pB3B"}