cursor-opencode-provider 0.3.1 → 0.4.0

package/dist/pricing-data.js

@@ -0,0 +1,414 @@
+/**
+ * AUTO-GENERATED by scripts/generate-cursor-pricing.ts — do not edit by hand.
+ * Pricing source: https://cursor.com/docs/models-and-pricing.md
+ * Context source: https://cursor.com/docs.md
+ * Regenerate: bun run generate:pricing
+ */
+export const CURSOR_PRICING_SOURCE = "https://cursor.com/docs/models-and-pricing.md";
+export const CURSOR_CONTEXT_SOURCE = "https://cursor.com/docs.md";
+export const CURSOR_MODEL_COSTS = {
+    "claude-fable-5": {
+        "input": 10,
+        "output": 50,
+        "cache_read": 1,
+        "cache_write": 12.5
+    },
+    "claude-haiku-4-5": {
+        "input": 1,
+        "output": 5,
+        "cache_read": 0.1,
+        "cache_write": 1.25
+    },
+    "claude-opus-4-5": {
+        "input": 5,
+        "output": 25,
+        "cache_read": 0.5,
+        "cache_write": 6.25
+    },
+    "claude-opus-4-6": {
+        "input": 5,
+        "output": 25,
+        "cache_read": 0.5,
+        "cache_write": 6.25
+    },
+    "claude-opus-4-7": {
+        "input": 5,
+        "output": 25,
+        "cache_read": 0.5,
+        "cache_write": 6.25
+    },
+    "claude-opus-4-8": {
+        "input": 5,
+        "output": 25,
+        "cache_read": 0.5,
+        "cache_write": 6.25
+    },
+    "claude-opus-5": {
+        "input": 5,
+        "output": 25,
+        "cache_read": 0.5,
+        "cache_write": 6.25
+    },
+    "claude-sonnet-4": {
+        "input": 3,
+        "output": 15,
+        "cache_read": 0.3,
+        "cache_write": 3.75,
+        "context_over_200k": {
+            "input": 6,
+            "output": 22.5,
+            "cache_read": 0.6,
+            "cache_write": 7.5
+        }
+    },
+    "claude-sonnet-4-5": {
+        "input": 3,
+        "output": 15,
+        "cache_read": 0.3,
+        "cache_write": 3.75
+    },
+    "claude-sonnet-4-6": {
+        "input": 3,
+        "output": 15,
+        "cache_read": 0.3,
+        "cache_write": 3.75
+    },
+    "claude-sonnet-5": {
+        "input": 3,
+        "output": 15,
+        "cache_read": 0.3,
+        "cache_write": 3.75
+    },
+    "gemini-2.5-flash": {
+        "input": 0.3,
+        "output": 2.5,
+        "cache_read": 0.03
+    },
+    "gemini-3-flash": {
+        "input": 0.5,
+        "output": 3,
+        "cache_read": 0.05
+    },
+    "gemini-3.1-pro": {
+        "input": 2,
+        "output": 12,
+        "cache_read": 0.2
+    },
+    "gemini-3.5-flash": {
+        "input": 1.5,
+        "output": 9,
+        "cache_read": 0.15
+    },
+    "gemini-3.6-flash": {
+        "input": 1.5,
+        "output": 7.5,
+        "cache_read": 0.15
+    },
+    "glm-5.2": {
+        "input": 1.4,
+        "output": 4.4,
+        "cache_read": 0.26
+    },
+    "gpt-5-mini": {
+        "input": 0.25,
+        "output": 2,
+        "cache_read": 0.025
+    },
+    "gpt-5.1": {
+        "input": 1.25,
+        "output": 10,
+        "cache_read": 0.125
+    },
+    "gpt-5.2": {
+        "input": 1.75,
+        "output": 14,
+        "cache_read": 0.175
+    },
+    "gpt-5.3-codex": {
+        "input": 1.75,
+        "output": 14,
+        "cache_read": 0.175
+    },
+    "gpt-5.4": {
+        "input": 2.5,
+        "output": 15,
+        "cache_read": 0.25,
+        "context_over_200k": {
+            "input": 5,
+            "output": 15,
+            "cache_read": 0.5
+        }
+    },
+    "gpt-5.4-mini": {
+        "input": 0.75,
+        "output": 4.5,
+        "cache_read": 0.075
+    },
+    "gpt-5.4-nano": {
+        "input": 0.2,
+        "output": 1.25,
+        "cache_read": 0.02
+    },
+    "gpt-5.5": {
+        "input": 5,
+        "output": 30,
+        "cache_read": 0.5,
+        "context_over_200k": {
+            "input": 10,
+            "output": 30,
+            "cache_read": 1
+        }
+    },
+    "gpt-5.6-luna": {
+        "input": 0.2,
+        "output": 1.2,
+        "cache_read": 0.02,
+        "cache_write": 0.25
+    },
+    "gpt-5.6-sol": {
+        "input": 5,
+        "output": 30,
+        "cache_read": 0.5,
+        "cache_write": 6.25,
+        "context_over_200k": {
+            "input": 10,
+            "output": 30,
+            "cache_read": 1,
+            "cache_write": 12.5
+        }
+    },
+    "gpt-5.6-terra": {
+        "input": 2,
+        "output": 12,
+        "cache_read": 0.2,
+        "cache_write": 2.5
+    },
+    "kimi-k2.7-code": {
+        "input": 0.95,
+        "output": 4,
+        "cache_read": 0.19
+    },
+    "kimi-k3": {
+        "input": 3,
+        "output": 15,
+        "cache_read": 0.3
+    }
+};
+export const CURSOR_MODEL_CONTEXTS = {
+    "claude-fable-5": {
+        "maxContext": 300000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-haiku-4-5": {
+        "maxContext": 200000
+    },
+    "claude-opus-4-5": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 200000
+    },
+    "claude-opus-4-6": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-opus-4-7": {
+        "maxContext": 300000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-opus-4-8": {
+        "maxContext": 300000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-opus-5": {
+        "maxContext": 300000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-sonnet-4": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-sonnet-4-5": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-sonnet-4-6": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "claude-sonnet-5": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "composer-2.5": {
+        "maxContext": 200000
+    },
+    "gemini-2.5-flash": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gemini-3-flash": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gemini-3.1-pro": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gemini-3.5-flash": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gemini-3.6-flash": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    },
+    "glm-5.2": {
+        "maxContext": 200000
+    },
+    "gpt-5-mini": {
+        "maxContext": 272000
+    },
+    "gpt-5.1": {
+        "maxContext": 272000
+    },
+    "gpt-5.2": {
+        "maxContext": 272000
+    },
+    "gpt-5.3-codex": {
+        "maxContext": 272000
+    },
+    "gpt-5.4": {
+        "maxContext": 272000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gpt-5.4-mini": {
+        "maxContext": 272000
+    },
+    "gpt-5.4-nano": {
+        "maxContext": 272000
+    },
+    "gpt-5.5": {
+        "maxContext": 272000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gpt-5.6-luna": {
+        "maxContext": 272000
+    },
+    "gpt-5.6-sol": {
+        "maxContext": 272000,
+        "maxContextForMaxMode": 1000000
+    },
+    "gpt-5.6-terra": {
+        "maxContext": 272000
+    },
+    "grok-4.5": {
+        "maxContext": 256000
+    },
+    "kimi-k2.7-code": {
+        "maxContext": 262000
+    },
+    "kimi-k3": {
+        "maxContext": 200000,
+        "maxContextForMaxMode": 1000000
+    }
+};
+export const CURSOR_MODEL_CAPABILITIES = {
+    "claude-fable-5": {
+        "supportsImages": true
+    },
+    "claude-haiku-4-5": {
+        "supportsImages": true
+    },
+    "claude-opus-4-5": {
+        "supportsImages": true
+    },
+    "claude-opus-4-6": {
+        "supportsImages": true
+    },
+    "claude-opus-4-7": {
+        "supportsImages": true
+    },
+    "claude-opus-4-8": {
+        "supportsImages": true
+    },
+    "claude-opus-5": {
+        "supportsImages": true
+    },
+    "claude-sonnet-4": {
+        "supportsImages": true
+    },
+    "claude-sonnet-4-5": {
+        "supportsImages": true
+    },
+    "claude-sonnet-4-6": {
+        "supportsImages": true
+    },
+    "claude-sonnet-5": {
+        "supportsImages": true
+    },
+    "composer-2.5": {
+        "supportsImages": true
+    },
+    "default": {
+        "supportsImages": false
+    },
+    "gemini-2.5-flash": {
+        "supportsImages": true
+    },
+    "gemini-3-flash": {
+        "supportsImages": true
+    },
+    "gemini-3.1-pro": {
+        "supportsImages": true
+    },
+    "gemini-3.5-flash": {
+        "supportsImages": true
+    },
+    "gemini-3.6-flash": {
+        "supportsImages": true
+    },
+    "glm-5.2": {
+        "supportsImages": false
+    },
+    "gpt-5-mini": {
+        "supportsImages": true
+    },
+    "gpt-5.1": {
+        "supportsImages": true
+    },
+    "gpt-5.2": {
+        "supportsImages": true
+    },
+    "gpt-5.3-codex": {
+        "supportsImages": true
+    },
+    "gpt-5.4": {
+        "supportsImages": true
+    },
+    "gpt-5.4-mini": {
+        "supportsImages": true
+    },
+    "gpt-5.4-nano": {
+        "supportsImages": true
+    },
+    "gpt-5.5": {
+        "supportsImages": true
+    },
+    "gpt-5.6-luna": {
+        "supportsImages": true
+    },
+    "gpt-5.6-sol": {
+        "supportsImages": true
+    },
+    "gpt-5.6-terra": {
+        "supportsImages": true
+    },
+    "grok-4.5": {
+        "supportsImages": false
+    },
+    "kimi-k2.7-code": {
+        "supportsImages": true
+    },
+    "kimi-k3": {
+        "supportsImages": true
+    }
+};

package/dist/pricing.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Cursor model token pricing for OpenCode cost reporting.
+ *
+ * Rates come from Cursor's public docs (Other Models pool = provider API price).
+ * Generated data lives in `pricing-data.ts`; regenerate with
+ * `bun run generate:pricing`. Unknown / unpublished models get no `cost`.
+ */
+/** Classic OpenCode / models.dev cost shape used in provider config. */
+export type OpenCodeModelCost = {
+    input: number;
+    output: number;
+    cache_read?: number;
+    cache_write?: number;
+    context_over_200k?: OpenCodeModelCost;
+};
+/** OpenCode 2.0 `Model.Info.cost` entry (array of tiered rates). */
+export type OpenCode2ModelCost = {
+    tier?: {
+        type: "context";
+        size: number;
+    };
+    input: number;
+    output: number;
+    cache: {
+        read: number;
+        write: number;
+    };
+};
+export type CursorPricingCoverage = {
+    priced: string[];
+    missing: string[];
+};
+/**
+ * Models we expose that Cursor does not currently publish numeric rates for
+ * on the Other Models table (Auto / first-party Cursor Models pool).
+ */
+export declare const CURSOR_UNPRICED_MODEL_IDS: readonly ["default", "composer-2.5", "grok-4.5"];
+export declare function validateOpenCodeModelCost(value: unknown, path?: string): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function isOpenCodeModelCost(value: unknown): value is OpenCodeModelCost;
+/** Strip synthetic OpenCode long-context suffix (`…-1m`, `…-1m-2`, …). */
+export declare function wireModelIdForPricing(modelId: string): {
+    baseId: string;
+    longContextEntry: boolean;
+};
+/**
+ * Look up classic OpenCode cost for a catalog / wire model id.
+ * Synthetic `-1m` entries retain both base and documented long-context rates.
+ */
+export declare function getCursorModelCost(modelId: string): OpenCodeModelCost | undefined;
+export declare function applyCursorModelCost<T extends Record<string, unknown>>(modelId: string, entry: T): T & {
+    cost?: OpenCodeModelCost;
+};
+/** Convert classic cost → OpenCode 2.0 `Model.Info.cost` array. */
+export declare function toOpenCode2Costs(cost: OpenCodeModelCost | undefined): OpenCode2ModelCost[];
+/**
+ * Coverage helper for CI / maintainer checks.
+ * Intentionally unpriced first-party ids are counted as priced (covered).
+ */
+export declare function checkCursorPricingCoverage(modelIds: string[]): CursorPricingCoverage;

package/dist/pricing.js

@@ -0,0 +1,127 @@
+/**
+ * Cursor model token pricing for OpenCode cost reporting.
+ *
+ * Rates come from Cursor's public docs (Other Models pool = provider API price).
+ * Generated data lives in `pricing-data.ts`; regenerate with
+ * `bun run generate:pricing`. Unknown / unpublished models get no `cost`.
+ */
+import { CURSOR_MODEL_COSTS } from "./pricing-data.js";
+/**
+ * Models we expose that Cursor does not currently publish numeric rates for
+ * on the Other Models table (Auto / first-party Cursor Models pool).
+ */
+export const CURSOR_UNPRICED_MODEL_IDS = ["default", "composer-2.5", "grok-4.5"];
+const UNPRICED = new Set(CURSOR_UNPRICED_MODEL_IDS);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonNegativeFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function collectCostValidationErrors(value, path, errors) {
+    if (!isRecord(value)) {
+        errors.push(`${path} must be an object`);
+        return;
+    }
+    if (!isNonNegativeFiniteNumber(value.input)) {
+        errors.push(`${path}.input must be a non-negative finite number`);
+    }
+    if (!isNonNegativeFiniteNumber(value.output)) {
+        errors.push(`${path}.output must be a non-negative finite number`);
+    }
+    if (value.cache_read !== undefined && !isNonNegativeFiniteNumber(value.cache_read)) {
+        errors.push(`${path}.cache_read must be a non-negative finite number`);
+    }
+    if (value.cache_write !== undefined && !isNonNegativeFiniteNumber(value.cache_write)) {
+        errors.push(`${path}.cache_write must be a non-negative finite number`);
+    }
+    if (value.context_over_200k !== undefined) {
+        collectCostValidationErrors(value.context_over_200k, `${path}.context_over_200k`, errors);
+    }
+}
+export function validateOpenCodeModelCost(value, path = "cost") {
+    const errors = [];
+    collectCostValidationErrors(value, path, errors);
+    return { valid: errors.length === 0, errors };
+}
+export function isOpenCodeModelCost(value) {
+    return validateOpenCodeModelCost(value).valid;
+}
+/** Strip synthetic OpenCode long-context suffix (`…-1m`, `…-1m-2`, …). */
+export function wireModelIdForPricing(modelId) {
+    const match = /^(.*)-1m(?:-(\d+))?$/.exec(modelId);
+    if (!match)
+        return { baseId: modelId, longContextEntry: false };
+    return { baseId: match[1], longContextEntry: true };
+}
+function asMutableCost(value) {
+    const copy = { input: value.input, output: value.output };
+    if (value.cache_read !== undefined)
+        copy.cache_read = value.cache_read;
+    if (value.cache_write !== undefined)
+        copy.cache_write = value.cache_write;
+    if (value.context_over_200k) {
+        copy.context_over_200k = asMutableCost(value.context_over_200k);
+    }
+    return copy;
+}
+/**
+ * Look up classic OpenCode cost for a catalog / wire model id.
+ * Synthetic `-1m` entries retain both base and documented long-context rates.
+ */
+export function getCursorModelCost(modelId) {
+    const { baseId } = wireModelIdForPricing(modelId);
+    const found = CURSOR_MODEL_COSTS[baseId];
+    if (!found)
+        return undefined;
+    return asMutableCost(found);
+}
+export function applyCursorModelCost(modelId, entry) {
+    const modelCost = getCursorModelCost(modelId);
+    if (!modelCost)
+        return entry;
+    return { ...entry, cost: modelCost };
+}
+/** Convert classic cost → OpenCode 2.0 `Model.Info.cost` array. */
+export function toOpenCode2Costs(cost) {
+    if (!cost)
+        return [];
+    const out = [
+        {
+            input: cost.input,
+            output: cost.output,
+            cache: {
+                read: cost.cache_read ?? 0,
+                write: cost.cache_write ?? 0,
+            },
+        },
+    ];
+    if (cost.context_over_200k) {
+        out.push({
+            tier: { type: "context", size: 200_000 },
+            input: cost.context_over_200k.input,
+            output: cost.context_over_200k.output,
+            cache: {
+                read: cost.context_over_200k.cache_read ?? 0,
+                write: cost.context_over_200k.cache_write ?? 0,
+            },
+        });
+    }
+    return out;
+}
+/**
+ * Coverage helper for CI / maintainer checks.
+ * Intentionally unpriced first-party ids are counted as priced (covered).
+ */
+export function checkCursorPricingCoverage(modelIds) {
+    const priced = [];
+    const missing = [];
+    for (const modelId of modelIds) {
+        const { baseId } = wireModelIdForPricing(modelId);
+        if (UNPRICED.has(baseId) || getCursorModelCost(modelId))
+            priced.push(modelId);
+        else
+            missing.push(modelId);
+    }
+    return { priced, missing };
+}

package/dist/protocol/messages.js

@@ -917,9 +917,30 @@ export function createMessageTypes() {
         { id: 2, name: "max_mode", type: "bool" },
         { id: 3, name: "parameters", type: "ParameterValue", repeated: true },
     ]);
+    addType(root, "SelectedImageDimension", [
+        { id: 1, name: "width", type: "int32" },
+        { id: 2, name: "height", type: "int32" },
+    ]);
+    addType(root, "SelectedImageBlobIdWithData", [
+        { id: 1, name: "blob_id", type: "bytes" },
+        { id: 2, name: "data", type: "bytes" },
+    ]);
+    addType(root, "SelectedImage", [
+        { id: 1, name: "blob_id", type: "bytes" },
+        { id: 8, name: "data", type: "bytes" },
+        { id: 9, name: "blob_id_with_data", type: "SelectedImageBlobIdWithData" },
+        { id: 2, name: "uuid", type: "string" },
+        { id: 3, name: "path", type: "string" },
+        { id: 4, name: "dimension", type: "SelectedImageDimension" },
+        { id: 7, name: "mime_type", type: "string" },
+    ], [{ name: "data_or_blob_id", fields: ["blob_id", "data", "blob_id_with_data"] }]);
+    addType(root, "SelectedContext", [
+        { id: 1, name: "selected_images", type: "SelectedImage", repeated: true },
+    ]);
     addType(root, "UserMessage", [
         { id: 1, name: "text", type: "string" },
         { id: 2, name: "message_id", type: "string" },
+        { id: 3, name: "selected_context", type: "SelectedContext" },
     ]);
     // RequestContext — UserMessageAction #2. Live per-turn tools go here
     // (AgentRunRequest.mcp_tools #4 is prewarm-only / empty on real turns).

package/dist/protocol/request.d.ts

@@ -1,10 +1,12 @@
 import { type OpencodeToolDef } from "./tools.js";
+import type { CursorImageInput } from "../image-input.js";
 export type SeedHistoryMessage = {
     role: "system" | "user" | "assistant";
     content: string;
 };
 export type RunRequestInput = {
     text: string;
+    images?: CursorImageInput[];
     modelId: string;
     conversationId: string;
     systemPrompt?: string;

package/dist/protocol/request.js

@@ -48,12 +48,21 @@ export function buildRunRequest(input) {
     const tools = input.tools ?? [];
     const mcpTools = input.toolDescriptors ?? (tools.length > 0 ? toolsToDescriptors(tools) : []);
     const requestContext = input.requestContext;
-    const userMessageAction = {
-        user_message: {
-            text: input.text,
-            message_id: msgId,
-        },
+    const userMessage = {
+        text: input.text,
+        message_id: msgId,
     };
+    if (input.images?.length) {
+        userMessage.selected_context = {
+            selected_images: input.images.map((image) => ({
+                data: image.data,
+                uuid: crypto.randomUUID(),
+                path: image.filename,
+                mime_type: image.mimeType,
+            })),
+        };
+    }
+    const userMessageAction = { user_message: userMessage };
     if (requestContext)
         userMessageAction.request_context = requestContext;
     const action = input.action === "resume"

package/dist/shared.d.ts

@@ -10,7 +10,7 @@ export declare const AVAILABLE_MODELS_PATH = "/aiserver.v1.AiService/AvailableMo
 export declare const SERVER_CONFIG_PATH = "/aiserver.v1.ServerConfigService/GetServerConfig";
 export declare const MODEL_CACHE_FILE = "cursor-models.json";
 /** Bumped when the on-disk model cache shape/semantics change (forces refetch). */
-export declare const MODEL_CACHE_SCHEMA_VERSION = 2;
+export declare const MODEL_CACHE_SCHEMA_VERSION = 3;
 export declare const MODEL_CACHE_TTL_MS = 86400000;
 export declare const VERSION_CACHE_FILE = "cursor-client-version.json";
 export declare const CONTENT_TYPE_CONNECT_PROTO = "application/connect+proto";

package/dist/shared.js

@@ -10,7 +10,7 @@ export const AVAILABLE_MODELS_PATH = "/aiserver.v1.AiService/AvailableModels";
 export const SERVER_CONFIG_PATH = "/aiserver.v1.ServerConfigService/GetServerConfig";
 export const MODEL_CACHE_FILE = "cursor-models.json";
 /** Bumped when the on-disk model cache shape/semantics change (forces refetch). */
-export const MODEL_CACHE_SCHEMA_VERSION = 2;
+export const MODEL_CACHE_SCHEMA_VERSION = 3;
 export const MODEL_CACHE_TTL_MS = 86_400_000;
 export const VERSION_CACHE_FILE = "cursor-client-version.json";
 export const CONTENT_TYPE_CONNECT_PROTO = "application/connect+proto";