opencode-translate 0.3.2 → 0.3.3

package/README.md

@@ -1,179 +1,41 @@
 # opencode-translate
 
-`opencode-translate` is an OpenCode plugin that lets the user chat in a configured `lang` while the main chat loop and compaction summariser only see English.
-
-## What It Does
-
-- Activates once per root session when any root-session user message contains a trigger keyword such as `$en`.
-- Translates user-authored text parts from `lang` to English before the main LLM sees them.
-- Stores the original user text, plus a cached English translation in part metadata.
-- Shows a visible `→ EN: ...` preview under each translated user text part.
-- Translates assistant text parts from English into `lang` when each text part completes.
-- Translates the built-in `question` tool's question text, header, and every option's label and description into `lang` so the TUI confirmation dialog is in the user's language. The tool output string returned to the LLM is restored to English, including translation of non-empty custom answers.
-- Stores assistant text as:
-
-```md
-<english>
-
-<!-- oc-translate:{nonce}:start -->
----
-
-**Translation ({lang}):**
-
-<translated>
-<!-- oc-translate:{nonce}:end -->
-```
-
-- Strips that trailer back out before later LLM turns, so the model history stays English-only.
-
-## v1 Limits
-
-- No mid-session toggle off.
-- No auto-detection of the user's language. `lang` is required.
-- No title translation or title-path English enforcement.
-- No subagent translation.
-- No translation of tool inputs, tool outputs, or reasoning parts.
-- Edited historical translated user messages are passed through as-is instead of being re-translated (the original edited text is what the LLM sees).
-
-## Hook Failure Handling
-
-Hooks never throw. If the translator fails (network error, auth failure, provider 4xx/5xx), the plugin:
-
-1. Logs the error via `client.app.log` (visible with `verbose: true`).
-2. Emits a `⚠️ Translation failed: …` synthetic part.
-3. Falls back to sending the original (untranslated) user text to the model.
-4. On activation-turn failure, it also rolls back activation so the next turn retries cleanly.
-
-A stalled provider request is additionally bounded by a 180s hard timeout per translation call, so a hung upstream cannot block the OpenCode session.
-
 ## Install
 
 ```bash
-npm install -g opencode-translate
+bun add -g opencode-translate
 ```
 
-Add it to `~/.config/opencode/opencode.json`:
+## Setup
 
-```json
+Add to `~/.config/opencode/opencode.jsonc`:
+
+```jsonc
 {
   "plugin": [
     ["opencode-translate", {
-      "model": "anthropic/claude-haiku-4-5",
-      "triggerKeywords": ["$en"],
-      "lang": "Korean",
-      "verbose": false
+      "model": "anthropic/claude-haiku-4-5", // model to use for translation
+      "lang": "Korean"                        // language you speak
     }]
   ]
 }
 ```
 
-Then make sure the translator provider has credentials. Any of these work:
-
-```bash
-opencode auth login anthropic
-export ANTHROPIC_API_KEY=...
-```
+## Usage
 
-Put the trigger in the message where translation should begin. Earlier messages in the session are left as-is:
+Prefix any message with `$en` to activate translation for that session.
 
-```text
-$en 프로젝트 루트의 package.json을 읽고 요약해줘
 ```
-
-## Options
-
-| Option | Type | Default |
-| --- | --- | --- |
-| `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
-
-Using this plugin means text goes to two model providers per turn:
-
-- the normal OpenCode chat provider
-- the configured `model` provider
-
-If you need strict single-provider or self-hosted-only behavior, do not enable this plugin.
-
-## Authentication
-
-Translator requests are made through the AI SDK directly, but provider setup mirrors OpenCode's resolved provider metadata from `client.provider.list()`: provider/model package metadata, configured provider options, model headers, resolved env/API keys, and plugin-auth-loader options that OpenCode exposes there.
-
-For OAuth records that OpenCode does not expose through the plugin SDK, the plugin reads OpenCode auth content/files and adapts the request only where direct AI SDK calls need it.
-
-## Anthropic OAuth Support
-
-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:
-
-- `user-agent: claude-cli/2.1.87 (external, cli)`
-- Required `anthropic-beta` headers (`oauth-2025-04-20`, `interleaved-thinking-2025-05-14`)
-- `?beta=true` appended to the `/v1/messages` URL
-- `x-anthropic-billing-header` block prepended to `system[]` (deterministic CCH of the first user message)
-- `"You are a Claude agent, built on Anthropic's Claude Agent SDK."` injected as the next `system[]` block
-
-The technique and constants are documented in https://github.com/ex-machina-co/opencode-anthropic-auth. See `src/anthropic-oauth.ts`.
-
-Tradeoffs:
-
-- Relies on an undocumented Anthropic OAuth request shape. Anthropic can change this at any time and force the plugin to stop using OAuth.
-- OpenCode upstream removed Anthropic OAuth support for legal / policy reasons. Installing this plugin reintroduces an equivalent code path in your environment.
-- Translator requests contribute to your Claude Pro/Max rate limit alongside OpenCode's main chat.
-
-If you prefer a plain API key, set `ANTHROPIC_API_KEY`, use `opencode auth login anthropic`, or pass `apiKey` in plugin options.
-
-## OpenAI OAuth Support
-
-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.
-
-For OpenAI, an OAuth record from `opencode auth login openai` takes precedence over `OPENAI_API_KEY` and plugin `apiKey`. API keys are only used when no OpenAI OAuth record is available.
-
-## Manual Smoke Test
-
-1. Install the plugin and configure `lang: "Korean"`.
-2. Start a new session and send `$en 프로젝트 루트의 package.json을 읽고 요약해줘`.
-3. Confirm the activation banner appears.
-4. Confirm the `→ EN: ...` preview appears under the user message.
-5. Confirm assistant text streams in English, then gains a translated trailer when the text part finishes.
-6. Confirm later messages in the same session translate without repeating `$en`.
-7. Confirm editing a historical translated user message falls back to the edited text being sent as-is (with a log entry visible under `verbose: true`).
-8. Confirm task-tool child sessions are not translated.
-9. Confirm the title remains in the source language in v1.
-
-## Development
-
-```bash
-bun install
-bun run check      # biome format + lint + organize imports (write)
-bun run typecheck  # tsgo (@typescript/native-preview, TS v7 beta)
-bun test
-```
-
-To only verify without writing:
-
-```bash
-bun run check:ci
+$en 프로젝트 루트의 package.json을 읽고 요약해줘
 ```
 
-### Release
+All subsequent messages in the same session are translated automatically — no need to repeat `$en`.
 
-`main` 브랜치에 푸시될 때 `package.json`의 `version`이 npm에 아직 없는 값이면, `.github/workflows/publish.yml`이 자동으로:
-
-1. `biome check`, `tsgo`, `bun test` 실행
-2. `npm publish --provenance --access public`
-3. `vX.Y.Z` git 태그와 GitHub Release 생성
-
-버전을 올리려면 `package.json`의 `version`만 수정해 main에 merge 하세요. 이미 publish된 버전이면 workflow는 publish를 건너뜁니다.
+## Options
 
-`docs/spec.en.md` is the source of truth for behavior.
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `model` | string | required | Translator model in `provider/model-id` form |
+| `lang` | string | required | Language you speak (e.g. `"Korean"`, `"Japanese"`) |
+| `trigger` | string[] | `["$en"]` | Keywords that activate translation |
+| `verbose` | boolean | `false` | Print translation logs |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-translate",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "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/chat-message.ts

@@ -42,7 +42,7 @@ async function activateFromTrigger(
   if (resolved.state || !resolved.canActivate)
     return { state: resolved.state, activatedThisTurn: false, aborted: false }
 
-  const match = findTriggerMatch(output.parts as TextPartLike[], ctx.options.triggerKeywords)
+  const match = findTriggerMatch(output.parts as TextPartLike[], ctx.options.trigger)
   if (!match) return { activatedThisTurn: false, aborted: false }
 
   const part = output.parts[match.partArrayIndex] as TextPartLike & { text: string }

package/src/activation/trigger.ts

@@ -5,14 +5,14 @@ function escapeRegex(value: string): string {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
 }
 
-export function findTriggerMatch(parts: TextPartLike[], triggerKeywords: string[]): TriggerMatch | undefined {
+export function findTriggerMatch(parts: TextPartLike[], trigger: string[]): TriggerMatch | undefined {
   let eligibleIndex = 0
   for (let partArrayIndex = 0; partArrayIndex < parts.length; partArrayIndex += 1) {
     const part = parts[partArrayIndex]
     if (!isUserAuthoredTextPart(part)) continue
 
     let bestForPart: TriggerMatch | undefined
-    for (const keyword of triggerKeywords) {
+    for (const keyword of trigger) {
       const pattern = new RegExp(`(^|[ \\t\\r\\n\\f\\v])${escapeRegex(keyword)}(?=$|[ \\t\\r\\n\\f\\v])`)
       const match = pattern.exec(part.text)
       if (!match) continue

package/src/auth/index.ts

@@ -10,7 +10,6 @@ import {
   type PluginClientLike,
   type ProviderInfo,
   parseTranslatorModel,
-  type ResolvedTranslateOptions,
   unwrapData,
 } from "../constants"
 import { buildOAuthFetch } from "./oauth-fetch"
@@ -67,11 +66,7 @@ async function getProvider(client: PluginClientLike, providerID: string): Promis
   }
 }
 
-export function createCredentialResolver(
-  client: PluginClientLike,
-  options: ResolvedTranslateOptions,
-  deps: AuthDependencies = {},
-) {
+export function createCredentialResolver(client: PluginClientLike, deps: AuthDependencies = {}) {
   const credentialCache = new Map<string, ResolvedCredential>()
   const oauthRefreshInflight = new Map<string, Promise<OAuthInfo>>()
   const runtime: AuthRuntime = {
@@ -133,12 +128,6 @@ export function createCredentialResolver(
     }
     if (cached && !(providerID === "openai" && cached.mode === "oauth" && authInfo?.type !== "oauth")) return cached
 
-    if (options.apiKey) {
-      const resolved = { providerID, provider, authInfo, apiKey: options.apiKey, mode: "apiKey" as const }
-      credentialCache.set(providerID, resolved)
-      return resolved
-    }
-
     const providerKey = normalizeProviderKey(provider?.key)
     if (providerKey) {
       const resolved = { providerID, provider, authInfo, apiKey: providerKey, mode: "apiKey" as const }

package/src/constants/errors.ts

@@ -13,7 +13,7 @@ export function buildInboundTranslationError(userLanguage: string, reason: strin
 
 export function buildAuthUnavailableError(providerID: string, envVar: string): Error {
   return new Error(
-    `[${PLUGIN_NAME}:AUTH_UNAVAILABLE] No credential found for provider "${providerID}". Set ${envVar} in the environment, run "opencode auth login ${providerID}", or set options.apiKey in opencode.json.`,
+    `[${PLUGIN_NAME}:AUTH_UNAVAILABLE] No credential found for provider "${providerID}". Set ${envVar} in the environment or run "opencode auth login ${providerID}".`,
   )
 }
 

package/src/constants/options.ts

@@ -1,4 +1,4 @@
-import { AUTH_ENV_FALLBACK, DEFAULT_TRIGGER_KEYWORDS, PLUGIN_NAME } from "./plugin"
+import { AUTH_ENV_FALLBACK, DEFAULT_TRIGGER, PLUGIN_NAME } from "./plugin"
 import type { ProviderInfo, ResolvedTranslateOptions } from "./types"
 
 export function resolveOptions(options: Record<string, unknown>): ResolvedTranslateOptions {
@@ -22,15 +22,14 @@ export function resolveOptions(options: Record<string, unknown>): ResolvedTransl
     )
   }
 
-  const triggerKeywords = Array.isArray(options.triggerKeywords)
-    ? options.triggerKeywords.filter((value): value is string => typeof value === "string" && value.length > 0)
-    : DEFAULT_TRIGGER_KEYWORDS
+  const trigger = Array.isArray(options.trigger)
+    ? options.trigger.filter((value): value is string => typeof value === "string" && value.length > 0)
+    : DEFAULT_TRIGGER
 
   return {
     model,
-    triggerKeywords: triggerKeywords.length > 0 ? triggerKeywords : [...DEFAULT_TRIGGER_KEYWORDS],
+    trigger: trigger.length > 0 ? trigger : [...DEFAULT_TRIGGER],
     lang,
-    apiKey: typeof options.apiKey === "string" && options.apiKey.length > 0 ? options.apiKey : undefined,
     verbose: options.verbose === true,
   }
 }

package/src/constants/plugin.ts

@@ -1,7 +1,7 @@
 export const PLUGIN_NAME = "opencode-translate"
 export const SPEC_VERSION = 2
 export const LLM_LANGUAGE = "English"
-export const DEFAULT_TRIGGER_KEYWORDS = ["$en"]
+export const DEFAULT_TRIGGER = ["$en"]
 export const OAUTH_DUMMY_KEY = "opencode-oauth-dummy-key"
 export const NONCE_PATTERN = /^[0-9a-f]{32}$/
 export const FAILURE_NOTICE = "_Translation unavailable for this segment._"

package/src/constants/types.ts

@@ -6,9 +6,8 @@ type ProviderSource = "env" | "config" | "custom" | "api"
 
 export interface ResolvedTranslateOptions {
   model: string
-  triggerKeywords: string[]
+  trigger: string[]
   lang: string
-  apiKey?: string
   verbose: boolean
 }
 

package/src/translator/index.ts

@@ -62,7 +62,7 @@ export function createTranslator(
   const sleepImpl = deps.sleep ?? ((ms: number) => sleep(ms))
   const now = deps.now ?? (() => Date.now())
   const generateTextImpl = deps.generateTextImpl ?? generateText
-  const credentialResolver = deps.credentialResolver ?? createCredentialResolver(client, options)
+  const credentialResolver = deps.credentialResolver ?? createCredentialResolver(client)
   const timeoutMs = deps.timeoutMs ?? DEFAULT_TRANSLATE_TIMEOUT_MS
 
   async function translateText(input: TranslateTextInput): Promise<string> {