cursor-opencode-provider 0.6.8 → 0.7.1

package/dist/opencode2/catalog.js

@@ -4,8 +4,8 @@ import { CURSOR_WIRE_MODEL_ID_KEY } from "../models.js";
 import { modelsToConfig } from "../model-config.js";
 import { toOpenCode2Costs } from "../pricing.js";
 /**
- * Catalog registration for the OpenCode 2.0 plugin — the replacement for the
- * classic plugin's `config` hook.
+ * In-memory provider registration for the OpenCode 2.0 plugin — the replacement
+ * for the classic plugin's `config` hook.
  *
  * Model naming, thinking suffixes, and long-context tiering are NOT reimplemented
  * here: we run the shared `modelsToConfig` and translate its output into the 2.0
@@ -17,10 +17,10 @@ export const CURSOR_INTEGRATION_ID = CURSOR_PROVIDER_ID;
  * `aisdk:` selects OpenCode 2.0's AI SDK path, which is what surfaces the
  * `aisdk.hook("sdk")` / `("language")` extension points we supply the provider
  * through. The suffix is this package's npm name so the host's built-in
- * `DynamicProviderPlugin` can still resolve it if our own hook is ever
- * bypassed — that fallback runs `npm.add(pkg)` against the *published*
- * registry into `<host-cache>/packages/<pkg>/node_modules/<pkg>`, ignoring
- * any local `file://` plugin path this process was loaded from.
+ * fallback can still resolve it if our own hook is ever bypassed — that
+ * fallback runs `npm.add(pkg)` against the *published* registry into
+ * `<host-cache>/packages/<pkg>/node_modules/<pkg>`, ignoring any local
+ * `file://` plugin path this process was loaded from.
  *
  * `CURSOR_OPENCODE2_DEV_ENTRY` overrides the suffix with an `aisdk:file://…`
  * spec instead, pointed at a local built entry file (e.g. `dist/index.js`,
@@ -32,19 +32,8 @@ export const CURSOR_INTEGRATION_ID = CURSOR_PROVIDER_ID;
 export const CURSOR_AISDK_PACKAGE = process.env.CURSOR_OPENCODE2_DEV_ENTRY
     ? `aisdk:${pathToFileURL(process.env.CURSOR_OPENCODE2_DEV_ENTRY).href}`
     : "aisdk:cursor-opencode-provider";
-/** Register (or update) the Cursor provider entry. `update` is an upsert. */
-export function applyCursorProvider(draft) {
-    draft.provider.update(CURSOR_PROVIDER_ID, (provider) => {
-        provider.id = CURSOR_PROVIDER_ID;
-        provider.name = "Cursor";
-        provider.package = CURSOR_AISDK_PACKAGE;
-        // Links the provider to the integration that stores its credentials, so
-        // `connection.active(...)` resolves the token the user set up via /connect.
-        provider.integrationID = CURSOR_INTEGRATION_ID;
-    });
-}
 /** Translate one `modelsToConfig` entry into the 2.0 `Model.Info` shape. */
-function applyModelEntry(draft, id, entry) {
+export function modelConfigEntryToInfo(id, entry) {
     const options = entry.options;
     // Long-context and Fast entries get synthetic OpenCode ids (`<id>-1m`,
     // `<id>-fast`, `<id>-1m-fast`) while still addressing the same Cursor model
@@ -54,38 +43,64 @@ function applyModelEntry(draft, id, entry) {
         ? options[CURSOR_WIRE_MODEL_ID_KEY]
         : id;
     const variants = Object.entries((entry.variants ?? {})).map(([variantId, settings]) => ({ id: variantId, settings: { ...settings } }));
-    draft.model.update(CURSOR_PROVIDER_ID, id, (model) => {
-        model.id = id;
-        model.modelID = wireId;
-        model.providerID = CURSOR_PROVIDER_ID;
-        model.name = entry.name;
-        const inputModalities = Array.isArray(entry.modalities?.input)
-            ? entry.modalities.input.filter((modality) => typeof modality === "string")
-            : ["text"];
-        const outputModalities = Array.isArray(entry.modalities?.output)
-            ? entry.modalities.output.filter((modality) => typeof modality === "string")
-            : ["text"];
-        model.capabilities = {
+    const inputModalities = Array.isArray(entry.modalities?.input)
+        ? entry.modalities.input.filter((modality) => typeof modality === "string")
+        : ["text"];
+    const outputModalities = Array.isArray(entry.modalities?.output)
+        ? entry.modalities.output.filter((modality) => typeof modality === "string")
+        : ["text"];
+    const info = {
+        id,
+        modelID: wireId,
+        providerID: CURSOR_PROVIDER_ID,
+        name: entry.name ?? id,
+        capabilities: {
             tools: entry.tool_call !== false,
             input: inputModalities,
             output: outputModalities,
-        };
-        model.limit = { context: entry.limit.context, output: entry.limit.output };
-        model.variants = variants;
-        model.status = "active";
-        model.enabled = true;
-        model.time = { released: 0 };
-        model.cost = toOpenCode2Costs(entry.cost);
-        // Carries the default variant parameters (and the wire id) through to
-        // doStream as provider options, matching the classic plugin.
-        if (options)
-            model.settings = { ...options };
-    });
+        },
+        limit: {
+            context: entry.limit?.context ?? 200_000,
+            output: entry.limit?.output ?? 8192,
+        },
+        variants,
+        status: "active",
+        enabled: true,
+        time: { released: 0 },
+        cost: toOpenCode2Costs(entry.cost),
+    };
+    if (options)
+        info.settings = { ...options };
+    return info;
 }
-/** Register every discovered Cursor model. Safe to re-run; `update` upserts. */
-export function applyCursorModels(draft, models) {
+/** Full model map for the in-memory provider inventory. */
+export function modelsToCatalogModelMap(models) {
     const config = modelsToConfig(models);
+    const out = {};
     for (const [id, entry] of Object.entries(config)) {
-        applyModelEntry(draft, id, entry);
+        out[id] = modelConfigEntryToInfo(id, entry);
     }
+    return out;
+}
+/**
+ * Publish discovered Cursor models into the live provider inventory.
+ *
+ * Skip while empty (keeps the last successful inventory through a no-op
+ * transform on first register), replace the definition with `editor.add`,
+ * then `ctx.provider.reload()`.
+ */
+export function applyCursorProviderInventory(editor, models, sourceConnection) {
+    if (models.length === 0)
+        return;
+    editor.add({
+        info: {
+            id: CURSOR_PROVIDER_ID,
+            name: "Cursor",
+            activation: "enabled",
+            package: CURSOR_AISDK_PACKAGE,
+            integrationID: CURSOR_INTEGRATION_ID,
+        },
+        models: Object.values(modelsToCatalogModelMap(models)),
+        ...(sourceConnection ? { sourceConnection } : {}),
+    });
 }

package/dist/opencode2/todo-tools.d.ts

@@ -0,0 +1,64 @@
+import type { ToolDraft } from "./types.js";
+/**
+ * OpenCode 2 snapshot: only `codemode === false` tools join the AI SDK catalog.
+ * Everything else is Code Mode-only (`packages/core/src/tool.ts` direct vs
+ * `codeModeTools`). Plugin-owned todo tools must opt into the direct catalog so
+ * Cursor can execute them without going through Code Mode.
+ */
+export declare const OPENCODE2_DIRECT_TOOL_OPTIONS: {
+    readonly codemode: false;
+};
+/**
+ * Force-enable plugin-owned `todowrite` / `todoread` on OpenCode 2.0.
+ * Default is off: the host has no TUI/desktop checklist, so advertising
+ * these in-memory tools is opt-in. OpenCode 1.x is unaffected (host builtin).
+ * Same truthy rule as `CURSOR_PROVIDER_DEBUG` (`1` or `true`).
+ */
+export declare const CURSOR_OPENCODE2_TODOS_ENV = "CURSOR_OPENCODE2_TODOS";
+export declare function isOpenCode2TodosEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * 1.x `todowrite` description, shortened. OpenCode 2 has no builtin todo
+ * tools; this is the catalog text the model sees when the 2.0 gate is on.
+ */
+export declare const TODOWRITE_DESCRIPTION = "Create and maintain a structured task list for the current coding session. Tracks progress, organizes multi-step work, and surfaces status to the user.\n\nUse proactively when the work is 3+ distinct steps, non-trivial, or the user lists multiple tasks. Skip single straightforward edits and purely informational questions.\n\nStates: pending, in_progress (exactly one at a time), completed, cancelled.\nUpdate status as you go. Mark completed only after the work \u2014 including verification \u2014 is actually done.";
+export declare const TODOREAD_DESCRIPTION = "Read the current session todo list. Takes no arguments. Returns the full list as JSON.";
+export declare const TODO_OUTPUT_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly todos: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "string";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["pending", "in_progress", "completed", "cancelled"];
+                    };
+                    readonly priority: {
+                        readonly type: "string";
+                        readonly enum: readonly ["high", "medium", "low"];
+                    };
+                };
+                readonly required: readonly ["id", "content", "status", "priority"];
+            };
+        };
+    };
+    readonly required: readonly ["todos"];
+};
+/** True when the host editor already owns this tool id. */
+export declare function hostHasTool(draft: ToolDraft, name: string): boolean;
+/**
+ * Register canonical `todowrite` / `todoread` when the 2.0 force-enable gate
+ * is on and the host catalog does not already advertise them. No-op when the
+ * gate is off (default), on OpenCode 1.x (this function is not called), and
+ * on any 2.x host that restores the tools.
+ */
+export declare function registerTodoTools(draft: ToolDraft): void;

package/dist/opencode2/todo-tools.js

@@ -0,0 +1,165 @@
+import { TODOREAD_TOOL, TODOWRITE_TOOL, getSessionTodos, setSessionTodos, } from "../todo-store.js";
+/**
+ * OpenCode 2 snapshot: only `codemode === false` tools join the AI SDK catalog.
+ * Everything else is Code Mode-only (`packages/core/src/tool.ts` direct vs
+ * `codeModeTools`). Plugin-owned todo tools must opt into the direct catalog so
+ * Cursor can execute them without going through Code Mode.
+ */
+export const OPENCODE2_DIRECT_TOOL_OPTIONS = { codemode: false };
+/**
+ * Force-enable plugin-owned `todowrite` / `todoread` on OpenCode 2.0.
+ * Default is off: the host has no TUI/desktop checklist, so advertising
+ * these in-memory tools is opt-in. OpenCode 1.x is unaffected (host builtin).
+ * Same truthy rule as `CURSOR_PROVIDER_DEBUG` (`1` or `true`).
+ */
+export const CURSOR_OPENCODE2_TODOS_ENV = "CURSOR_OPENCODE2_TODOS";
+export function isOpenCode2TodosEnabled(env = process.env) {
+    const value = env[CURSOR_OPENCODE2_TODOS_ENV]?.toLowerCase();
+    return value === "1" || value === "true";
+}
+/**
+ * 1.x `todowrite` description, shortened. OpenCode 2 has no builtin todo
+ * tools; this is the catalog text the model sees when the 2.0 gate is on.
+ */
+export const TODOWRITE_DESCRIPTION = `Create and maintain a structured task list for the current coding session. Tracks progress, organizes multi-step work, and surfaces status to the user.
+
+Use proactively when the work is 3+ distinct steps, non-trivial, or the user lists multiple tasks. Skip single straightforward edits and purely informational questions.
+
+States: pending, in_progress (exactly one at a time), completed, cancelled.
+Update status as you go. Mark completed only after the work — including verification — is actually done.`;
+export const TODOREAD_DESCRIPTION = "Read the current session todo list. Takes no arguments. Returns the full list as JSON.";
+const TODO_ITEM_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        id: { type: "string", description: "Optional stable item id" },
+        content: { type: "string", description: "Brief description of the task" },
+        status: {
+            type: "string",
+            description: "pending, in_progress, completed, or cancelled",
+            enum: ["pending", "in_progress", "completed", "cancelled"],
+        },
+        priority: {
+            type: "string",
+            description: "high, medium, or low",
+            enum: ["high", "medium", "low"],
+        },
+    },
+    required: ["content"],
+};
+const TODO_OUTPUT_ITEM_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        id: { type: "string" },
+        content: { type: "string" },
+        status: {
+            type: "string",
+            enum: ["pending", "in_progress", "completed", "cancelled"],
+        },
+        priority: {
+            type: "string",
+            enum: ["high", "medium", "low"],
+        },
+    },
+    required: ["id", "content", "status", "priority"],
+};
+export const TODO_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        todos: { type: "array", items: TODO_OUTPUT_ITEM_SCHEMA },
+    },
+    required: ["todos"],
+};
+function todoResult(todos) {
+    const content = JSON.stringify(todos, null, 2);
+    return {
+        output: { todos },
+        content,
+        metadata: { todos },
+    };
+}
+function sessionIDFromContext(context) {
+    if (!context || typeof context !== "object") {
+        throw new Error("OpenCode 2.0 todo tool context did not provide a sessionID");
+    }
+    const id = context.sessionID;
+    if (typeof id !== "string" || !id) {
+        throw new Error("OpenCode 2.0 todo tool context did not provide a sessionID");
+    }
+    return id;
+}
+/** True when the host editor already owns this tool id. */
+export function hostHasTool(draft, name) {
+    if (typeof draft.get === "function") {
+        try {
+            if (draft.get(name))
+                return true;
+        }
+        catch {
+            // Host get() may throw for unknown ids; fall through to list().
+        }
+    }
+    if (typeof draft.list === "function") {
+        try {
+            return draft.list().some((tool) => tool.id === name || tool.name === name);
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+/**
+ * Register canonical `todowrite` / `todoread` when the 2.0 force-enable gate
+ * is on and the host catalog does not already advertise them. No-op when the
+ * gate is off (default), on OpenCode 1.x (this function is not called), and
+ * on any 2.x host that restores the tools.
+ */
+export function registerTodoTools(draft) {
+    if (!isOpenCode2TodosEnabled())
+        return;
+    if (!hostHasTool(draft, TODOWRITE_TOOL)) {
+        draft.add({
+            name: TODOWRITE_TOOL,
+            description: TODOWRITE_DESCRIPTION,
+            input: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    todos: {
+                        type: "array",
+                        description: "The updated todo list (replace-all snapshot)",
+                        items: TODO_ITEM_SCHEMA,
+                    },
+                },
+                required: ["todos"],
+            },
+            output: TODO_OUTPUT_SCHEMA,
+            options: OPENCODE2_DIRECT_TOOL_OPTIONS,
+            execute: async (input, context) => {
+                const sessionID = sessionIDFromContext(context);
+                const todos = setSessionTodos(sessionID, input?.todos);
+                return todoResult(todos);
+            },
+        });
+    }
+    if (!hostHasTool(draft, TODOREAD_TOOL)) {
+        draft.add({
+            name: TODOREAD_TOOL,
+            description: TODOREAD_DESCRIPTION,
+            input: {
+                type: "object",
+                additionalProperties: false,
+                properties: {},
+            },
+            output: TODO_OUTPUT_SCHEMA,
+            options: OPENCODE2_DIRECT_TOOL_OPTIONS,
+            execute: async (_input, context) => {
+                const sessionID = sessionIDFromContext(context);
+                return todoResult(getSessionTodos(sessionID));
+            },
+        });
+    }
+}