opencode-translate 0.2.3 → 0.3.0

package/README.md

@@ -58,7 +58,7 @@ Add it to `~/.config/opencode/opencode.json`:
 {
   "plugin": [
     ["opencode-translate", {
-      "translatorModel": "anthropic/claude-haiku-4-5",
+      "model": "anthropic/claude-haiku-4-5",
       "triggerKeywords": ["$en"],
       "lang": "Korean",
       "verbose": false
@@ -84,12 +84,14 @@ $en 프로젝트 루트의 package.json을 읽고 요약해줘
 
 | Option | Type | Default |
 | --- | --- | --- |
-| `translatorModel` | string | `anthropic/claude-haiku-4-5` |
+| `model` | string | Required |
 | `triggerKeywords` | string[] | `[$en]` |
 | `lang` | string | Required |
 | `apiKey` | string | `undefined` |
 | `verbose` | boolean | `false` |
 
+Set `model` to the translator model in `provider/model-id` form, such as `"anthropic/claude-haiku-4-5"`.
+
 Set `lang` to the full name of the language the user reads and writes, such as `"Korean"`, `"Japanese"`, or `"Brazilian Portuguese"`. The value is injected directly into translation prompts, so language code mapping is not required.
 
 ## Privacy
@@ -97,7 +99,7 @@ Set `lang` to the full name of the language the user reads and writes, such as `
 Using this plugin means text goes to two model providers per turn:
 
 - the normal OpenCode chat provider
-- the configured `translatorModel` provider
+- the configured `model` provider
 
 If you need strict single-provider or self-hosted-only behavior, do not enable this plugin.
 
@@ -109,7 +111,7 @@ For OAuth records that OpenCode does not expose through the plugin SDK, the plug
 
 ## Anthropic OAuth Support
 
-If `translatorModel` uses Anthropic and OpenCode auth is backed by Anthropic OAuth (Claude Pro/Max), the plugin reuses those OAuth credentials for translation requests.
+If `model` uses Anthropic and OpenCode auth is backed by Anthropic OAuth (Claude Pro/Max), the plugin reuses those OAuth credentials for translation requests.
 
 Anthropic's `/v1/messages` endpoint rejects OAuth-authenticated requests that do not match the Claude Code CLI fingerprint (response: `429 rate_limit_error` with an empty `"Error"` message). To pass, the plugin applies the same transformation that `@ex-machina/opencode-anthropic-auth` uses for OpenCode's main chat, but only for its own translator requests:
 
@@ -131,7 +133,7 @@ If you prefer a plain API key, set `ANTHROPIC_API_KEY`, use `opencode auth login
 
 ## OpenAI OAuth Support
 
-If `translatorModel` uses OpenAI and OpenCode auth is backed by the ChatGPT/Codex OAuth flow, the plugin reuses those OAuth credentials for translation requests.
+If `model` uses OpenAI and OpenCode auth is backed by the ChatGPT/Codex OAuth flow, the plugin reuses those OAuth credentials for translation requests.
 
 For OAuth-backed OpenAI requests, the plugin routes the OpenAI AI SDK request to `https://chatgpt.com/backend-api/codex/responses`, adds the required Codex beta/originator headers, normalizes the request body to Codex's expected typed `input` shape, and converts Codex SSE responses back to JSON for translation calls. This supports models such as `openai/gpt-5.5` when your ChatGPT plan has access.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-translate",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "OpenCode plugin that lets the user chat in a configured language while the main chat loop only sees English.",
   "type": "module",
   "main": "src/index.ts",

package/src/activation/parts.ts

@@ -8,7 +8,7 @@ import {
 import { createSyntheticPartID } from "../translator"
 
 export function createActivationBannerText(options: ResolvedTranslateOptions): string {
-  const { modelID } = parseTranslatorModel(options.translatorModel)
+  const { modelID } = parseTranslatorModel(options.model)
   return `✓ Translation mode enabled · translator: ${modelID} · language: ${options.lang}`
 }
 

package/src/constants/options.ts

@@ -1,7 +1,20 @@
-import { AUTH_ENV_FALLBACK, DEFAULT_TRANSLATOR_MODEL, DEFAULT_TRIGGER_KEYWORDS, PLUGIN_NAME } from "./plugin"
+import { AUTH_ENV_FALLBACK, DEFAULT_TRIGGER_KEYWORDS, PLUGIN_NAME } from "./plugin"
 import type { ProviderInfo, ResolvedTranslateOptions } from "./types"
 
 export function resolveOptions(options: Record<string, unknown>): ResolvedTranslateOptions {
+  const model = typeof options.model === "string" ? options.model.trim() : ""
+  if (!model) {
+    throw new Error(
+      `[${PLUGIN_NAME}:INVALID_OPTIONS] options.model is required. Set it to the translator model, e.g. "anthropic/claude-haiku-4-5".`,
+    )
+  }
+  const slash = model.indexOf("/")
+  if (slash < 1 || slash === model.length - 1) {
+    throw new Error(
+      `[${PLUGIN_NAME}:INVALID_OPTIONS] options.model must be in provider/model-id form, e.g. "anthropic/claude-haiku-4-5".`,
+    )
+  }
+
   const lang = typeof options.lang === "string" ? options.lang.trim() : ""
   if (!lang) {
     throw new Error(
@@ -14,10 +27,7 @@ export function resolveOptions(options: Record<string, unknown>): ResolvedTransl
     : DEFAULT_TRIGGER_KEYWORDS
 
   return {
-    translatorModel:
-      typeof options.translatorModel === "string" && options.translatorModel.includes("/")
-        ? options.translatorModel
-        : DEFAULT_TRANSLATOR_MODEL,
+    model,
     triggerKeywords: triggerKeywords.length > 0 ? triggerKeywords : [...DEFAULT_TRIGGER_KEYWORDS],
     lang,
     apiKey: typeof options.apiKey === "string" && options.apiKey.length > 0 ? options.apiKey : undefined,

package/src/constants/plugin.ts

@@ -1,7 +1,6 @@
 export const PLUGIN_NAME = "opencode-translate"
 export const SPEC_VERSION = 2
 export const LLM_LANGUAGE = "English"
-export const DEFAULT_TRANSLATOR_MODEL = "anthropic/claude-haiku-4-5"
 export const DEFAULT_TRIGGER_KEYWORDS = ["$en"]
 export const OAUTH_DUMMY_KEY = "opencode-oauth-dummy-key"
 export const NONCE_PATTERN = /^[0-9a-f]{32}$/

package/src/constants/types.ts

@@ -5,7 +5,7 @@ export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promis
 type ProviderSource = "env" | "config" | "custom" | "api"
 
 export interface ResolvedTranslateOptions {
-  translatorModel: string
+  model: string
   triggerKeywords: string[]
   lang: string
   apiKey?: string

package/src/translator/index.ts

@@ -70,8 +70,8 @@ export function createTranslator(
     if (input.sourceLanguage === input.targetLanguage) return input.text
 
     const startedAt = now()
-    const { providerID, modelID } = parseTranslatorModel(options.translatorModel)
-    const credentials = await credentialResolver.resolve(options.translatorModel)
+    const { providerID, modelID } = parseTranslatorModel(options.model)
+    const credentials = await credentialResolver.resolve(options.model)
     const modelInfo = resolveModelInfo(credentials.provider, modelID)
     const factory = await loadFactory(providerID, modelInfo)
     const provider = instantiateProvider(factory, providerID, credentials, modelInfo)
@@ -113,7 +113,7 @@ export function createTranslator(
             chars_out: translated.length,
             ms: now() - startedAt,
             cached: false,
-            model: options.translatorModel,
+            model: options.model,
           },
         },
       })