@cursor/july 0.1.101 → 0.1.103

package/dist/internal/tenant-slack/relay.js

@@ -0,0 +1,138 @@
+/**
+ * Relay-backed Slack posting for managed deployments.
+ *
+ * On AgentSDK v2 managed deployments the fork never receives a Slack token.
+ * The delivery envelope carries the matched automation's configured Slack
+ * **channel ids** only (`managedAutomation.slackChannels`, absent when the
+ * customer toggled "Send to Slack" off); each post goes through the control
+ * plane's Slack relay
+ * (`/internal/agent-serve/agent-sdk-slack-relay/:automationUuid`),
+ * authenticated with the pod's own `CURSOR_API_KEY`. The relay re-checks
+ * that the channel is configured on exactly that automation, renders the
+ * markdown, and posts as the Cursor Slack app with the customer's stored
+ * workspace token.
+ *
+ * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
+ * excluded from the published `@cursor/july` npm package (see the `files`
+ * whitelist); consumed by internal deployments via relative source imports.
+ */
+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, resolveApiKeySync, } from "../cursor/credentials.js";
+/**
+ * Path prefix of the backend relay route. Must match the mount in
+ * `backend/server/src/agentServe/agentServeEndpoints.ts`
+ * (`agentSdkSlackRelayRoutes`).
+ */
+export const AGENT_SDK_SLACK_RELAY_PATH_PREFIX = "/internal/agent-serve/agent-sdk-slack-relay";
+/** Mirrors the relay's body bound; longer summaries are truncated client-side. */
+export const AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS = 12000;
+const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Relay URL scoped to the source managed automation the delivery envelope
+ * attributed, so the relay checks the destination against exactly that
+ * automation's configured channels.
+ */
+export function relaySlackPostUrl(args) {
+    const trimmed = args.baseUrl.endsWith("/")
+        ? args.baseUrl.slice(0, -1)
+        : args.baseUrl;
+    return `${trimmed}${AGENT_SDK_SLACK_RELAY_PATH_PREFIX}/${encodeURIComponent(args.automationUuid)}`;
+}
+/** Pod credential + external API base URL, or undefined off-platform. */
+export function resolveRelaySlackTarget() {
+    const resolved = resolveApiKeySync();
+    if (resolved === undefined) {
+        return undefined;
+    }
+    return { relayBaseUrl: cursorExternalApiUrl(), apiKey: resolved.apiKey };
+}
+function truncateMessage(message) {
+    if (message.length <= AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS) {
+        return message;
+    }
+    const marker = "\n\n_(truncated)_";
+    return `${message.slice(0, AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS - marker.length)}${marker}`;
+}
+function describeError(error) {
+    if (error instanceof Error) {
+        return error.name === "TimeoutError" || error.name === "AbortError"
+            ? "relay request timed out"
+            : error.message;
+    }
+    return String(error);
+}
+/**
+ * Post one markdown message to one configured channel through the relay.
+ * Never throws: every failure is a `{ ok: false }` result so product code
+ * can log and continue (a Slack outage must not fail the review).
+ */
+export function postRelaySlackMessage(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        const channel = args.channel.trim();
+        if (channel === "") {
+            return { ok: false, channel, status: 0, error: "empty channel" };
+        }
+        const target = ((_a = args.resolve) !== null && _a !== void 0 ? _a : resolveRelaySlackTarget)();
+        if (target === undefined) {
+            return {
+                ok: false,
+                channel,
+                status: 0,
+                error: "no Cursor credential for the Slack relay",
+            };
+        }
+        const fetchImpl = (_b = args.fetchImpl) !== null && _b !== void 0 ? _b : fetch;
+        const url = relaySlackPostUrl({
+            baseUrl: target.relayBaseUrl,
+            automationUuid: args.automationUuid,
+        });
+        let response;
+        try {
+            response = yield fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${target.apiKey}`,
+                    "content-type": "application/json",
+                    accept: "application/json",
+                },
+                body: JSON.stringify(Object.assign({ channel, message: truncateMessage(args.message) }, (args.threadTs === undefined ? {} : { threadTs: args.threadTs }))),
+                signal: AbortSignal.timeout((_c = args.timeoutMs) !== null && _c !== void 0 ? _c : DEFAULT_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            return { ok: false, channel, status: 0, error: describeError(error) };
+        }
+        let body;
+        try {
+            body = yield response.json();
+        }
+        catch (_d) {
+            body = undefined;
+        }
+        const record = typeof body === "object" && body !== null && !Array.isArray(body)
+            ? body
+            : {};
+        if (!response.ok || record.ok !== true) {
+            return {
+                ok: false,
+                channel,
+                status: response.status,
+                error: typeof record.error === "string" && record.error !== ""
+                    ? record.error
+                    : `relay responded ${response.status}`,
+            };
+        }
+        return Object.assign(Object.assign({ ok: true, channel: typeof record.channel === "string" ? record.channel : channel }, (typeof record.ts === "string" ? { ts: record.ts } : {})), (typeof record.permalink === "string"
+            ? { permalink: record.permalink }
+            : {}));
+    });
+}

package/dist/internal/testing/scm-continuation-fixtures.d.ts

@@ -0,0 +1,33 @@
+/**
+ * GitLab / Bitbucket continuation fixtures shared by the two continuation
+ * vocabulary copies — `internal/continuation-identity.ts` (July) and the
+ * control plane's `agentSdkConversationIdentity.ts` (server-shared). Both
+ * suites import this one module, so a payload shape or key format that only
+ * one copy understands fails CI on the other side.
+ *
+ * Pure data: no imports, so the server-shared suite can load it by relative
+ * path without pulling `@cursor/july` into the control plane.
+ */
+export interface ScmContinuationFixture {
+    name: string;
+    kind: "gitlab" | "bitbucket";
+    /** Conversation type the channel's `<kind>.<type>/v2` selector names. */
+    type: "gitlab-mr" | "bitbucket-pr";
+    /**
+     * Mailbox event name. Bitbucket Data Center deliveries arrive with their
+     * Cloud-normalized key (`pr:opened` → `pullrequest:created`) next to the
+     * raw DC payload.
+     */
+    eventType: string;
+    payload: Record<string, unknown>;
+    /** `cont:` key, or `undefined` when the delivery stamps `evt:`. */
+    expectedKey: string | undefined;
+}
+export interface ScmDefaultSelectorFixture {
+    kind: "gitlab" | "bitbucket";
+    eventTypes: readonly string[];
+    expected: string;
+}
+export declare const SCM_CONTINUATION_FIXTURES: readonly ScmContinuationFixture[];
+export declare const SCM_DEFAULT_SELECTOR_FIXTURES: readonly ScmDefaultSelectorFixture[];
+//# sourceMappingURL=scm-continuation-fixtures.d.ts.map

package/dist/internal/testing/scm-continuation-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scm-continuation-fixtures.d.ts","sourceRoot":"","sources":["../../../src/internal/testing/scm-continuation-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,yEAAyE;IACzE,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC;IACnC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqCD,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAgMtE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,SAAS,yBAAyB,EAuB3E,CAAC"}

package/dist/internal/testing/scm-continuation-fixtures.js

@@ -0,0 +1,253 @@
+/**
+ * GitLab / Bitbucket continuation fixtures shared by the two continuation
+ * vocabulary copies — `internal/continuation-identity.ts` (July) and the
+ * control plane's `agentSdkConversationIdentity.ts` (server-shared). Both
+ * suites import this one module, so a payload shape or key format that only
+ * one copy understands fails CI on the other side.
+ *
+ * Pure data: no imports, so the server-shared suite can load it by relative
+ * path without pulling `@cursor/july` into the control plane.
+ */
+const GITLAB_PROJECT = {
+    id: 1234,
+    name: "api",
+    path_with_namespace: "Acme/platform/api",
+    web_url: "https://gitlab.com/Acme/platform/api",
+    default_branch: "main",
+};
+const GITLAB_MERGE_REQUEST = {
+    id: 9001,
+    iid: 42,
+    title: "Add widgets",
+    state: "opened",
+    source_branch: "feature/widgets",
+    target_branch: "main",
+    url: "https://gitlab.com/Acme/platform/api/-/merge_requests/42",
+    last_commit: { id: "0123456789abcdef0123456789abcdef01234567" },
+};
+const BITBUCKET_CLOUD_REPOSITORY = {
+    type: "repository",
+    full_name: "acme/widgets",
+    name: "widgets",
+    uuid: "{5f2d1d5e-6d66-4f5b-9d3e-1b6e5b1c2f3a}",
+    workspace: { slug: "acme", uuid: "{a4f1c5d0-1111-4a2b-8c3d-9e0f1a2b3c4d}" },
+    links: { html: { href: "https://bitbucket.org/acme/widgets" } },
+};
+const BITBUCKET_DC_REPOSITORY = {
+    slug: "widgets",
+    id: 17,
+    name: "widgets",
+    project: { key: "ACME", id: 3, name: "Acme" },
+};
+export const SCM_CONTINUATION_FIXTURES = [
+    {
+        name: "gitlab merge_request open",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "merge_request",
+        payload: {
+            object_kind: "merge_request",
+            event_type: "merge_request",
+            user: { id: 7, username: "alice", name: "Alice" },
+            project: GITLAB_PROJECT,
+            object_attributes: Object.assign(Object.assign({}, GITLAB_MERGE_REQUEST), { action: "open" }),
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!42",
+    },
+    {
+        name: "gitlab merge_request update (new commits)",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "merge_request",
+        payload: {
+            object_kind: "merge_request",
+            event_type: "merge_request",
+            user: { id: 7, username: "alice", name: "Alice" },
+            project: GITLAB_PROJECT,
+            object_attributes: Object.assign(Object.assign({}, GITLAB_MERGE_REQUEST), { action: "update", oldrev: "fedcba9876543210fedcba9876543210fedcba98" }),
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!42",
+    },
+    {
+        name: "gitlab note on merge request",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "note",
+        payload: {
+            object_kind: "note",
+            event_type: "note",
+            user: { id: 8, username: "bob", name: "Bob" },
+            project: GITLAB_PROJECT,
+            object_attributes: {
+                id: 501,
+                note: "Looks good",
+                noteable_type: "MergeRequest",
+                noteable_id: 9001,
+            },
+            merge_request: GITLAB_MERGE_REQUEST,
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!42",
+    },
+    {
+        name: "gitlab note on issue",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "note",
+        payload: {
+            object_kind: "note",
+            event_type: "note",
+            user: { id: 8, username: "bob", name: "Bob" },
+            project: GITLAB_PROJECT,
+            object_attributes: {
+                id: 502,
+                note: "Tracking",
+                noteable_type: "Issue",
+                noteable_id: 300,
+            },
+            issue: { id: 300, iid: 9, title: "Bug" },
+        },
+        expectedKey: undefined,
+    },
+    {
+        name: "gitlab pipeline attached to a merge request",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "pipeline",
+        payload: {
+            object_kind: "pipeline",
+            project: GITLAB_PROJECT,
+            object_attributes: { id: 77, status: "success", sha: "0123456789ab" },
+            merge_request: { iid: 42, id: 9001, title: "Add widgets" },
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!42",
+    },
+    {
+        name: "gitlab pipeline without a merge request",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "pipeline",
+        payload: {
+            object_kind: "pipeline",
+            project: GITLAB_PROJECT,
+            object_attributes: { id: 78, status: "success", sha: "0123456789ab" },
+            merge_request: null,
+        },
+        expectedKey: undefined,
+    },
+    {
+        name: "gitlab push",
+        kind: "gitlab",
+        type: "gitlab-mr",
+        eventType: "push",
+        payload: {
+            object_kind: "push",
+            event_name: "push",
+            ref: "refs/heads/main",
+            project: GITLAB_PROJECT,
+            commits: [],
+        },
+        expectedKey: undefined,
+    },
+    {
+        name: "bitbucket cloud pullrequest:created",
+        kind: "bitbucket",
+        type: "bitbucket-pr",
+        eventType: "pullrequest:created",
+        payload: {
+            repository: BITBUCKET_CLOUD_REPOSITORY,
+            actor: { display_name: "Alice", uuid: "{u-1}" },
+            pullrequest: {
+                id: 7,
+                title: "Add widgets",
+                state: "OPEN",
+                source: {
+                    branch: { name: "feature/widgets" },
+                    commit: { hash: "0123456789ab" },
+                },
+                destination: { branch: { name: "main" }, commit: { hash: "fedcba98" } },
+                links: {
+                    html: { href: "https://bitbucket.org/acme/widgets/pull-requests/7" },
+                },
+            },
+        },
+        expectedKey: "cont:bitbucket-pr:acme/widgets#7",
+    },
+    {
+        name: "bitbucket data center pr:opened (normalized to pullrequest:created)",
+        kind: "bitbucket",
+        type: "bitbucket-pr",
+        eventType: "pullrequest:created",
+        payload: {
+            eventKey: "pr:opened",
+            date: "2026-09-01T12:00:00+0000",
+            actor: { name: "alice", displayName: "Alice", id: 1 },
+            pullRequest: {
+                id: 7,
+                title: "Add widgets",
+                state: "OPEN",
+                open: true,
+                fromRef: {
+                    id: "refs/heads/feature/widgets",
+                    displayId: "feature/widgets",
+                    latestCommit: "0123456789ab",
+                    repository: BITBUCKET_DC_REPOSITORY,
+                },
+                toRef: {
+                    id: "refs/heads/main",
+                    displayId: "main",
+                    latestCommit: "fedcba98",
+                    repository: BITBUCKET_DC_REPOSITORY,
+                },
+            },
+        },
+        expectedKey: "cont:bitbucket-pr:acme/widgets#7",
+    },
+    {
+        name: "bitbucket cloud pullrequest:comment_created",
+        kind: "bitbucket",
+        type: "bitbucket-pr",
+        eventType: "pullrequest:comment_created",
+        payload: {
+            repository: BITBUCKET_CLOUD_REPOSITORY,
+            actor: { display_name: "Bob", uuid: "{u-2}" },
+            pullrequest: { id: 7, title: "Add widgets", state: "OPEN" },
+            comment: { id: 11, content: { raw: "Looks good" } },
+        },
+        expectedKey: "cont:bitbucket-pr:acme/widgets#7",
+    },
+    {
+        name: "bitbucket cloud repo:push",
+        kind: "bitbucket",
+        type: "bitbucket-pr",
+        eventType: "repo:push",
+        payload: {
+            repository: BITBUCKET_CLOUD_REPOSITORY,
+            actor: { display_name: "Alice", uuid: "{u-1}" },
+            push: { changes: [] },
+        },
+        expectedKey: undefined,
+    },
+];
+export const SCM_DEFAULT_SELECTOR_FIXTURES = [
+    { kind: "gitlab", eventTypes: ["merge_request"], expected: "gitlab.mr/v2" },
+    {
+        kind: "gitlab",
+        eventTypes: ["merge_request", "note"],
+        expected: "gitlab.mr/v2",
+    },
+    {
+        kind: "gitlab",
+        eventTypes: ["merge_request", "push"],
+        expected: "gitlab.none/v2",
+    },
+    {
+        kind: "bitbucket",
+        eventTypes: ["pullrequest:created", "pullrequest:updated"],
+        expected: "bitbucket.pr/v2",
+    },
+    {
+        kind: "bitbucket",
+        eventTypes: ["pullrequest:created", "repo:push"],
+        expected: "bitbucket.none/v2",
+    },
+];

package/dist/internal/tool-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/internal/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AAoDrB,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAMvE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,kBAAkB,CAU3E"}
+{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/internal/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AAuDrB,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAMvE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,kBAAkB,CAU3E"}

package/dist/internal/tool-catalog.js

@@ -15,13 +15,16 @@
  * presentation concern is not worth the authoring surface).
  */
 const WELL_KNOWN_TOOL_TITLES = {
-    diff: "Show change diffs",
-    glob: "Find files by pattern",
-    grep: "Search file contents",
-    ls: "List a directory",
-    read: "Read a file",
+    Delete: "Delete a file",
+    Diff: "Show change diffs",
+    Glob: "Find files by pattern",
+    Grep: "Search file contents",
+    LS: "List a directory",
+    Read: "Read a file",
+    StrReplace: "Replace text in a file",
+    Write: "Write a file",
+    script: "Run a TypeScript program",
     search: "Search with a typed query",
-    write: "Write a file",
 };
 function catalogTitle(tool) {
     var _a;

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

@@ -17,6 +17,20 @@ export interface EstimateTurnCostInput {
 }
 export type EstimateTurnCostFn = (input: EstimateTurnCostInput) => Promise<TurnCost | undefined>;
 export declare function modelSettingId(model: ModelSetting): string;
+/**
+ * This estimate-cost client treats OpenAI-compat usage as **provider-gross**
+ * (local playground: `prompt_tokens` includes `cachedPromptTokens`). Catalog
+ * `costForBaseTier` assumes Anthropic / billing-style disjoint nets and ADDs
+ * `cacheRead × cachedRate` on top of `input × inputRate`, so we send
+ * `input − cache` for Grok / xAI / GPT / o-series.
+ *
+ * Non-OpenAI-compat models are left alone. `input < cache` is only a
+ * defensive clamp (avoid a negative uncached count), not a detector for
+ * billed / openaiProxy-shaped tokens. Cloud catalog fallback with already-
+ * netted OpenAI-compat usage is out of scope here.
+ */
+export declare function isOpenAiCompatGrossCacheModel(model: ModelSetting): boolean;
+export declare function toCatalogDisjointUsage(usage: TurnUsage, model?: ModelSetting): TurnUsage;
 export declare function roundCostUsd(usd: number): number;
 export declare function turnCostFromCents(args: {
     model: string | ModelSetting;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAQ1E;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,KAAK,CAAC,EAAE,YAAY,GACnB,SAAS,CAYX;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,CAkD/B"}

package/dist/internal/turn-cost.js

@@ -16,6 +16,35 @@ import { cursorExternalApiUrl, resolveApiKey } from "./cursor/credentials.js";
 export function modelSettingId(model) {
     return typeof model === "string" ? model : model.id;
 }
+/**
+ * This estimate-cost client treats OpenAI-compat usage as **provider-gross**
+ * (local playground: `prompt_tokens` includes `cachedPromptTokens`). Catalog
+ * `costForBaseTier` assumes Anthropic / billing-style disjoint nets and ADDs
+ * `cacheRead × cachedRate` on top of `input × inputRate`, so we send
+ * `input − cache` for Grok / xAI / GPT / o-series.
+ *
+ * Non-OpenAI-compat models are left alone. `input < cache` is only a
+ * defensive clamp (avoid a negative uncached count), not a detector for
+ * billed / openaiProxy-shaped tokens. Cloud catalog fallback with already-
+ * netted OpenAI-compat usage is out of scope here.
+ */
+export function isOpenAiCompatGrossCacheModel(model) {
+    const id = modelSettingId(model).toLowerCase();
+    return (id.includes("grok") ||
+        id.includes("xai") ||
+        id.includes("gpt") ||
+        /(^|[-_/])o[1-9]/.test(id));
+}
+export function toCatalogDisjointUsage(usage, model) {
+    if (model === undefined || !isOpenAiCompatGrossCacheModel(model)) {
+        return usage;
+    }
+    const cachedTokens = usage.cacheReadTokens + usage.cacheWriteTokens;
+    if (cachedTokens === 0 || usage.inputTokens < cachedTokens) {
+        return usage;
+    }
+    return Object.assign(Object.assign({}, usage), { inputTokens: usage.inputTokens - cachedTokens });
+}
 export function roundCostUsd(usd) {
     return Math.round(usd * 1e6) / 1e6;
 }
@@ -36,13 +65,16 @@ export function turnCostFromCents(args) {
 }
 export function estimateTurnCostFromApi(input) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e;
-        var _f;
+        var _a;
+        var _b;
         const resolved = yield resolveApiKey();
         if (resolved === undefined) {
             return undefined;
         }
         const model = modelSettingId(input.model);
+        const catalogUsage = input.usage === undefined
+            ? undefined
+            : toCatalogDisjointUsage(input.usage, input.model);
         const response = yield fetch(`${cursorExternalApiUrl()}/v1/models/estimate-cost`, {
             method: "POST",
             headers: {
@@ -51,10 +83,10 @@ export function estimateTurnCostFromApi(input) {
             },
             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,
+                inputTokens: catalogUsage === null || catalogUsage === void 0 ? void 0 : catalogUsage.inputTokens,
+                outputTokens: catalogUsage === null || catalogUsage === void 0 ? void 0 : catalogUsage.outputTokens,
+                cacheReadTokens: catalogUsage === null || catalogUsage === void 0 ? void 0 : catalogUsage.cacheReadTokens,
+                cacheWriteTokens: catalogUsage === null || catalogUsage === void 0 ? void 0 : catalogUsage.cacheWriteTokens,
                 agentId: input.agentId,
                 conversationId: input.conversationId,
                 runId: input.runId,
@@ -67,15 +99,15 @@ export function estimateTurnCostFromApi(input) {
         try {
             body = (yield response.json());
         }
-        catch (_g) {
+        catch (_c) {
             return undefined;
         }
-        if (typeof ((_e = body.cost) === null || _e === void 0 ? void 0 : _e.rawCostCents) !== "number" ||
+        if (typeof ((_a = body.cost) === null || _a === void 0 ? void 0 : _a.rawCostCents) !== "number" ||
             typeof body.cost.chargedCents !== "number") {
             return undefined;
         }
         return turnCostFromCents({
-            model: (_f = body.model) !== null && _f !== void 0 ? _f : model,
+            model: (_b = body.model) !== null && _b !== void 0 ? _b : model,
             cost: body.cost,
             source: body.source === "usage" ? "usage" : "catalog",
         });

package/dist/internal/v2-hosting.d.ts

@@ -0,0 +1,22 @@
+import type { AgentArchitecture } from "../types.js";
+import { type CursorManagedV2StoreIds } from "./cursor/hosted-store-secrets.js";
+export type AgentV2Hosting = {
+    kind: "not-v2";
+} | {
+    kind: "self-hosted";
+} | {
+    kind: "cursor-managed";
+    resolveStoreIds: () => CursorManagedV2StoreIds;
+};
+/**
+ * Close the architecture/hosting inputs into a compiler-owned union.
+ *
+ * Managed freeze processes exist before task bind, so store resolution stays
+ * lazy. Consumers can branch once on `kind`; managed storage operations then
+ * receive a resolver whose successful result always contains both ids.
+ */
+export declare function resolveAgentV2Hosting(input: {
+    architecture: AgentArchitecture | undefined;
+    env?: NodeJS.ProcessEnv;
+}): AgentV2Hosting;
+//# sourceMappingURL=v2-hosting.d.ts.map

package/dist/internal/v2-hosting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,CAAC;AAEN;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAYjB"}

package/dist/internal/v2-hosting.js

@@ -0,0 +1,23 @@
+import { requireCursorManagedV2StoreIdsSync, } from "./cursor/hosted-store-secrets.js";
+import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
+/**
+ * Close the architecture/hosting inputs into a compiler-owned union.
+ *
+ * Managed freeze processes exist before task bind, so store resolution stays
+ * lazy. Consumers can branch once on `kind`; managed storage operations then
+ * receive a resolver whose successful result always contains both ids.
+ */
+export function resolveAgentV2Hosting(input) {
+    var _a;
+    if (input.architecture !== "v2") {
+        return { kind: "not-v2" };
+    }
+    const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
+    if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
+        return { kind: "self-hosted" };
+    }
+    return {
+        kind: "cursor-managed",
+        resolveStoreIds: () => requireCursorManagedV2StoreIdsSync(env),
+    };
+}

package/dist/internal/workspace-sync.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sync `agent/sandbox/workspace/**` seed files onto an Agent Store so
+ * cloud-runtime turns read them from the store mount (the first cloud prompt
+ * names the directory; see `buildCloudWorkspaceSection`). Hosted deployments
+ * write store-root `workspace/<path>`. Local `serve`/`run` with
+ * `runtime: "cloud"` writes `agent-serve/<agent>/workspace/<path>` on the
+ * USER store.
+ */
+import { type FileSink } from "../files.js";
+import type { SeedFile } from "../types.js";
+/**
+ * Mirror the seed tree onto the store at its authored relative paths and
+ * delete keys no seed claims so redeploys drop removed files. Every seed
+ * loads and validates before the store is touched.
+ */
+export declare function syncWorkspaceToStore(args: {
+    sink: FileSink;
+    seedFiles: readonly SeedFile[];
+    /** Store-root directory that holds the seed tree. Defaults to `workspace/`. */
+    workspacePrefix?: string;
+}): Promise<void>;
+//# sourceMappingURL=workspace-sync.d.ts.map

package/dist/internal/workspace-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../../src/internal/workspace-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAchB"}