opencode-translate 0.1.1 → 0.1.3

package/src/constants/errors.ts

@@ -0,0 +1,24 @@
+import { PLUGIN_NAME } from "./plugin"
+
+export function normalizeReason(error: unknown): string {
+  const raw = error instanceof Error ? error.message : String(error)
+  return raw.split(/\r?\n/, 1)[0].trim().slice(0, 200)
+}
+
+export function buildInboundTranslationError(sourceLanguage: string, reason: string): Error {
+  return new Error(
+    `[${PLUGIN_NAME}:INBOUND_TRANSLATION_FAILED] Failed to translate user message from ${sourceLanguage} to en: ${reason}`,
+  )
+}
+
+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.`,
+  )
+}
+
+export function buildOAuthRefreshError(providerID: string, reason: string): Error {
+  return new Error(
+    `[${PLUGIN_NAME}:OAUTH_REFRESH_FAILED] Failed to refresh OAuth token for provider "${providerID}": ${reason}. Re-authenticate with "opencode auth login ${providerID}".`,
+  )
+}

package/src/constants/guards.ts

@@ -0,0 +1,34 @@
+import { LLM_LANGUAGE, NONCE_PATTERN } from "./plugin"
+import type { SDKResponseLike, TextPartLike, TranslateState } from "./types"
+
+function isNonEmptyString(value: unknown): value is string {
+  return typeof value === "string" && value.length > 0
+}
+
+export function unwrapData<T>(value: T | SDKResponseLike<T>): T {
+  if (value && typeof value === "object" && "data" in value && (value as SDKResponseLike<T>).data !== undefined) {
+    return (value as SDKResponseLike<T>).data as T
+  }
+  return value as T
+}
+
+export function isTranslateStateRecord(value: unknown): value is TranslateState {
+  if (!value || typeof value !== "object") return false
+  const record = value as Record<string, unknown>
+  return (
+    record.translate_enabled === true &&
+    record.translate_llm_lang === LLM_LANGUAGE &&
+    isNonEmptyString(record.translate_source_lang) &&
+    isNonEmptyString(record.translate_display_lang) &&
+    isNonEmptyString(record.translate_nonce) &&
+    NONCE_PATTERN.test(record.translate_nonce)
+  )
+}
+
+export function isTextPart(part: TextPartLike): part is TextPartLike & { text: string } {
+  return part.type === "text" && typeof part.text === "string"
+}
+
+export function isUserAuthoredTextPart(part: TextPartLike): part is TextPartLike & { text: string } {
+  return isTextPart(part) && part.synthetic !== true && part.ignored !== true
+}

package/src/constants/options.ts

@@ -0,0 +1,37 @@
+import { AUTH_ENV_FALLBACK, DEFAULT_TRANSLATOR_MODEL, DEFAULT_TRIGGER_KEYWORDS } from "./plugin"
+import type { ProviderInfo, ResolvedTranslateOptions } from "./types"
+
+export function resolveOptions(options: Record<string, unknown>): ResolvedTranslateOptions {
+  const triggerKeywords = Array.isArray(options.triggerKeywords)
+    ? options.triggerKeywords.filter((value): value is string => typeof value === "string" && value.length > 0)
+    : DEFAULT_TRIGGER_KEYWORDS
+
+  return {
+    translatorModel:
+      typeof options.translatorModel === "string" && options.translatorModel.includes("/")
+        ? options.translatorModel
+        : DEFAULT_TRANSLATOR_MODEL,
+    triggerKeywords: triggerKeywords.length > 0 ? triggerKeywords : [...DEFAULT_TRIGGER_KEYWORDS],
+    sourceLanguage:
+      typeof options.sourceLanguage === "string" && options.sourceLanguage.trim() ? options.sourceLanguage : "en",
+    displayLanguage:
+      typeof options.displayLanguage === "string" && options.displayLanguage.trim() ? options.displayLanguage : "en",
+    apiKey: typeof options.apiKey === "string" && options.apiKey.length > 0 ? options.apiKey : undefined,
+    verbose: options.verbose === true,
+  }
+}
+
+export function getEnvVarHint(provider: ProviderInfo | undefined): string {
+  return provider?.env[0] || AUTH_ENV_FALLBACK
+}
+
+export function parseTranslatorModel(model: string): { providerID: string; modelID: string } {
+  const slash = model.indexOf("/")
+  if (slash < 1 || slash === model.length - 1) {
+    return { providerID: "anthropic", modelID: model }
+  }
+  return {
+    providerID: model.slice(0, slash),
+    modelID: model.slice(slash + 1),
+  }
+}

package/src/constants/plugin.ts

@@ -0,0 +1,10 @@
+export const PLUGIN_NAME = "opencode-translate"
+export const SPEC_VERSION = 1
+export const LLM_LANGUAGE = "en"
+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}$/
+export const FAILURE_NOTICE = "_Translation unavailable for this segment._"
+export const AUTH_ENV_FALLBACK = "the provider's API key env var"
+export const USER_AGENT = `${PLUGIN_NAME}/0.0.0`

package/src/constants/types.ts

@@ -0,0 +1,147 @@
+import type { LLM_LANGUAGE } from "./plugin"
+
+export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
+
+type ProviderSource = "env" | "config" | "custom" | "api"
+
+export interface ResolvedTranslateOptions {
+  translatorModel: string
+  triggerKeywords: string[]
+  sourceLanguage: string
+  displayLanguage: string
+  apiKey?: string
+  verbose: boolean
+}
+
+export interface TranslateState {
+  translate_enabled: true
+  translate_source_lang: string
+  translate_display_lang: string
+  translate_llm_lang: typeof LLM_LANGUAGE
+  translate_nonce: string
+}
+
+export interface StoredTextMetadata extends Record<string, unknown> {
+  translate_enabled?: boolean
+  translate_source_lang?: string
+  translate_display_lang?: string
+  translate_llm_lang?: string
+  translate_nonce?: string
+  translate_role?: string
+  translate_spec_version?: number
+  translate_source_hash?: string
+  translate_en?: string
+  translate_part_index?: number
+  compaction_continue?: boolean
+}
+
+interface SessionLike {
+  id: string
+  parentID?: string | null
+}
+
+interface MessageLike {
+  id: string
+  sessionID: string
+  role: string
+}
+
+export interface TextPartLike {
+  id: string
+  sessionID: string
+  messageID: string
+  type: string
+  text?: string
+  synthetic?: boolean
+  ignored?: boolean
+  metadata?: Record<string, unknown>
+}
+
+export interface MessageWithPartsLike {
+  info: MessageLike
+  parts: TextPartLike[]
+}
+
+export interface ProviderInfo {
+  id: string
+  source: ProviderSource
+  env: string[]
+  key?: string
+  options?: Record<string, unknown>
+  models?: Record<string, unknown>
+}
+
+interface ProviderListResponseLike {
+  all: ProviderInfo[]
+}
+
+interface ApiAuthInfo {
+  type: "api"
+  key: string
+  metadata?: Record<string, string>
+}
+
+export interface OAuthInfo {
+  type: "oauth"
+  refresh: string
+  access: string
+  expires: number
+  accountId?: string
+  enterpriseUrl?: string
+}
+
+interface WellKnownInfo {
+  type: "wellknown"
+  key: string
+  token: string
+}
+
+export type AuthInfo = ApiAuthInfo | OAuthInfo | WellKnownInfo
+
+export interface SDKResponseLike<T> {
+  data?: T
+}
+
+export interface PluginClientLike {
+  session: {
+    get(
+      input: (
+        | { sessionID: string; directory?: string; workspace?: string }
+        | { path: { id: string }; query?: { directory?: string; workspace?: string } }
+      ) & { throwOnError?: boolean },
+      options?: { throwOnError?: boolean },
+    ): Promise<SessionLike | SDKResponseLike<SessionLike>>
+    messages(
+      input: (
+        | { sessionID: string; directory?: string; workspace?: string }
+        | { path: { id: string }; query?: { directory?: string; workspace?: string; limit?: number; before?: string } }
+      ) & { throwOnError?: boolean },
+      options?: { throwOnError?: boolean },
+    ): Promise<MessageWithPartsLike[] | SDKResponseLike<MessageWithPartsLike[]>>
+    message(
+      input: (
+        | { sessionID: string; messageID: string; directory?: string; workspace?: string }
+        | { path: { id: string; messageID: string }; query?: { directory?: string; workspace?: string } }
+      ) & { throwOnError?: boolean },
+      options?: { throwOnError?: boolean },
+    ): Promise<MessageWithPartsLike | SDKResponseLike<MessageWithPartsLike>>
+  }
+  provider: {
+    list(options?: {
+      throwOnError?: boolean
+    }): Promise<ProviderListResponseLike | SDKResponseLike<ProviderListResponseLike>>
+  }
+  auth: {
+    set(input: { path: { id: string }; body: AuthInfo }): Promise<unknown>
+  }
+  app: {
+    log(input: {
+      body: {
+        service: string
+        level: string
+        message: string
+        extra?: Record<string, unknown>
+      }
+    }): Promise<unknown>
+  }
+}

package/src/constants.ts

@@ -1,261 +1,5 @@
-export const PLUGIN_NAME = "opencode-translate"
-export const SPEC_VERSION = 1
-export const LLM_LANGUAGE = "en"
-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}$/
-export const FAILURE_NOTICE = "_Translation unavailable for this segment._"
-export const AUTH_ENV_FALLBACK = "the provider's API key env var"
-export const USER_AGENT = `${PLUGIN_NAME}/0.0.0`
-
-export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
-
-export type ProviderSource = "env" | "config" | "custom" | "api"
-
-export interface TranslateOptions {
-  translatorModel?: string
-  triggerKeywords?: string[]
-  sourceLanguage?: string
-  displayLanguage?: string
-  apiKey?: string
-  verbose?: boolean
-}
-
-export interface ResolvedTranslateOptions {
-  translatorModel: string
-  triggerKeywords: string[]
-  sourceLanguage: string
-  displayLanguage: string
-  apiKey?: string
-  verbose: boolean
-}
-
-export interface TranslateState {
-  translate_enabled: true
-  translate_source_lang: string
-  translate_display_lang: string
-  translate_llm_lang: typeof LLM_LANGUAGE
-  translate_nonce: string
-}
-
-export interface StoredTextMetadata extends Record<string, unknown> {
-  translate_enabled?: boolean
-  translate_source_lang?: string
-  translate_display_lang?: string
-  translate_llm_lang?: string
-  translate_nonce?: string
-  translate_role?: string
-  translate_spec_version?: number
-  translate_source_hash?: string
-  translate_en?: string
-  translate_part_index?: number
-  compaction_continue?: boolean
-}
-
-export interface SessionLike {
-  id: string
-  parentID?: string | null
-}
-
-export interface MessageLike {
-  id: string
-  sessionID: string
-  role: string
-}
-
-export interface TextPartLike {
-  id: string
-  sessionID: string
-  messageID: string
-  type: string
-  text?: string
-  synthetic?: boolean
-  ignored?: boolean
-  metadata?: Record<string, unknown>
-}
-
-export interface MessageWithPartsLike {
-  info: MessageLike
-  parts: TextPartLike[]
-}
-
-export interface ProviderInfo {
-  id: string
-  source: ProviderSource
-  env: string[]
-  key?: string
-  options?: Record<string, unknown>
-  models?: Record<string, unknown>
-}
-
-export interface ProviderListResponseLike {
-  all: ProviderInfo[]
-}
-
-export interface ApiAuthInfo {
-  type: "api"
-  key: string
-  metadata?: Record<string, string>
-}
-
-export interface OAuthInfo {
-  type: "oauth"
-  refresh: string
-  access: string
-  expires: number
-  accountId?: string
-  enterpriseUrl?: string
-}
-
-export interface WellKnownInfo {
-  type: "wellknown"
-  key: string
-  token: string
-}
-
-export type AuthInfo = ApiAuthInfo | OAuthInfo | WellKnownInfo
-
-export interface SDKResponseLike<T> {
-  data?: T
-}
-
-export interface PluginClientLike {
-  session: {
-    get(
-      input: (
-        | { sessionID: string; directory?: string; workspace?: string }
-        | { path: { id: string }; query?: { directory?: string; workspace?: string } }
-      ) & { throwOnError?: boolean },
-      options?: { throwOnError?: boolean },
-    ): Promise<SessionLike | SDKResponseLike<SessionLike>>
-    messages(
-      input: (
-        | { sessionID: string; directory?: string; workspace?: string }
-        | { path: { id: string }; query?: { directory?: string; workspace?: string; limit?: number; before?: string } }
-      ) & { throwOnError?: boolean },
-      options?: { throwOnError?: boolean },
-    ): Promise<MessageWithPartsLike[] | SDKResponseLike<MessageWithPartsLike[]>>
-    message(
-      input: (
-        | { sessionID: string; messageID: string; directory?: string; workspace?: string }
-        | { path: { id: string; messageID: string }; query?: { directory?: string; workspace?: string } }
-      ) & { throwOnError?: boolean },
-      options?: { throwOnError?: boolean },
-    ): Promise<MessageWithPartsLike | SDKResponseLike<MessageWithPartsLike>>
-  }
-  provider: {
-    list(options?: {
-      throwOnError?: boolean
-    }): Promise<ProviderListResponseLike | SDKResponseLike<ProviderListResponseLike>>
-  }
-  auth: {
-    set(input: { path: { id: string }; body: AuthInfo }): Promise<unknown>
-  }
-  app: {
-    log(input: {
-      body: {
-        service: string
-        level: string
-        message: string
-        extra?: Record<string, unknown>
-      }
-    }): Promise<unknown>
-  }
-}
-
-export interface TranslationPreviewInfo {
-  english: string
-  sourceHash: string
-  eligibleIndex: number
-}
-
-export function resolveOptions(options: Record<string, unknown>): ResolvedTranslateOptions {
-  const triggerKeywords = Array.isArray(options.triggerKeywords)
-    ? options.triggerKeywords.filter((value): value is string => typeof value === "string" && value.length > 0)
-    : DEFAULT_TRIGGER_KEYWORDS
-
-  return {
-    translatorModel:
-      typeof options.translatorModel === "string" && options.translatorModel.includes("/")
-        ? options.translatorModel
-        : DEFAULT_TRANSLATOR_MODEL,
-    triggerKeywords: triggerKeywords.length > 0 ? triggerKeywords : [...DEFAULT_TRIGGER_KEYWORDS],
-    sourceLanguage:
-      typeof options.sourceLanguage === "string" && options.sourceLanguage.trim() ? options.sourceLanguage : "en",
-    displayLanguage:
-      typeof options.displayLanguage === "string" && options.displayLanguage.trim() ? options.displayLanguage : "en",
-    apiKey: typeof options.apiKey === "string" && options.apiKey.length > 0 ? options.apiKey : undefined,
-    verbose: options.verbose === true,
-  }
-}
-
-export function getEnvVarHint(provider: ProviderInfo | undefined): string {
-  return provider?.env[0] || AUTH_ENV_FALLBACK
-}
-
-export function isNonEmptyString(value: unknown): value is string {
-  return typeof value === "string" && value.length > 0
-}
-
-export function unwrapData<T>(value: T | SDKResponseLike<T>): T {
-  if (value && typeof value === "object" && "data" in value && (value as SDKResponseLike<T>).data !== undefined) {
-    return (value as SDKResponseLike<T>).data as T
-  }
-  return value as T
-}
-
-export function normalizeReason(error: unknown): string {
-  const raw = error instanceof Error ? error.message : String(error)
-  return raw.split(/\r?\n/, 1)[0].trim().slice(0, 200)
-}
-
-export function buildInboundTranslationError(sourceLanguage: string, reason: string): Error {
-  return new Error(
-    `[${PLUGIN_NAME}:INBOUND_TRANSLATION_FAILED] Failed to translate user message from ${sourceLanguage} to en: ${reason}`,
-  )
-}
-
-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.`,
-  )
-}
-
-export function buildOAuthRefreshError(providerID: string, reason: string): Error {
-  return new Error(
-    `[${PLUGIN_NAME}:OAUTH_REFRESH_FAILED] Failed to refresh OAuth token for provider "${providerID}": ${reason}. Re-authenticate with "opencode auth login ${providerID}".`,
-  )
-}
-
-export function isTranslateStateRecord(value: unknown): value is TranslateState {
-  if (!value || typeof value !== "object") return false
-  const record = value as Record<string, unknown>
-  return (
-    record.translate_enabled === true &&
-    record.translate_llm_lang === LLM_LANGUAGE &&
-    isNonEmptyString(record.translate_source_lang) &&
-    isNonEmptyString(record.translate_display_lang) &&
-    isNonEmptyString(record.translate_nonce) &&
-    NONCE_PATTERN.test(record.translate_nonce)
-  )
-}
-
-export function isTextPart(part: TextPartLike): part is TextPartLike & { text: string } {
-  return part.type === "text" && typeof part.text === "string"
-}
-
-export function isUserAuthoredTextPart(part: TextPartLike): part is TextPartLike & { text: string } {
-  return isTextPart(part) && part.synthetic !== true && part.ignored !== true
-}
-
-export function parseTranslatorModel(model: string): { providerID: string; modelID: string } {
-  const slash = model.indexOf("/")
-  if (slash < 1 || slash === model.length - 1) {
-    return { providerID: "anthropic", modelID: model }
-  }
-  return {
-    providerID: model.slice(0, slash),
-    modelID: model.slice(slash + 1),
-  }
-}
+export * from "./constants/errors"
+export * from "./constants/guards"
+export * from "./constants/options"
+export * from "./constants/plugin"
+export * from "./constants/types"

package/src/labels.ts

@@ -13,5 +13,3 @@ const DISPLAY_LANGUAGE_LABELS: Record<string, string> = {
 export function getDisplayLanguageLabel(displayLanguage: string): string {
   return DISPLAY_LANGUAGE_LABELS[displayLanguage] ?? `Translation (${displayLanguage})`
 }
-
-export { DISPLAY_LANGUAGE_LABELS }

package/src/question-tool.ts

@@ -9,8 +9,10 @@
 //   3. OpenCode publishes `question.asked`; the TUI shows the translated
 //      dialog and the user picks an option (or types a custom answer).
 //   4. `tool.execute.after` hook reverses the substitution using the
-//      snapshot we captured in step 2, so the tool output string delivered
-//      back to the LLM stays in English.
+//      snapshot we captured in step 2. Selected options are restored by
+//      label mapping; non-empty custom answers are translated like normal
+//      user messages, so the output delivered back to the LLM stays in
+//      English.
 //
 // A per-callID snapshot is kept so mapping a user-selected translated label
 // back to its original English label is deterministic.
@@ -35,6 +37,11 @@ export interface QuestionToolOutput {
   metadata?: { answers?: readonly (readonly string[])[] } | Record<string, unknown>
 }
 
+export interface RestoreQuestionOutputOptions {
+  translateCustomAnswer?: (text: string) => Promise<string>
+  onTranslationError?: (error: unknown) => Promise<void> | void
+}
+
 function cloneQuestion(q: TextRecord): TextRecord {
   return {
     question: q.question,
@@ -80,9 +87,8 @@ async function assignTranslation(
   container[key] = unwrapEchoedTextEnvelope(translated)
 }
 
-// Translate every display-facing string in `args` in parallel. Returns the
-// snapshot of the translated form so the caller can pair it with the
-// pre-translation snapshot taken with `snapshotQuestions`.
+// Translate every display-facing string in `args` in parallel. The caller can
+// snapshot the translated form afterward with `snapshotQuestions`.
 export async function translateQuestionArgs(
   args: QuestionArgs,
   translate: (text: string) => Promise<string>,
@@ -101,44 +107,61 @@ export async function translateQuestionArgs(
   await Promise.all(jobs)
 }
 
-// Given the user-selected labels (`answers`), find the matching translated
-// option and return its original English label. If no match (e.g. a custom
-// free-text answer), return the label verbatim so the LLM still sees what
-// the user actually typed.
-function restoreLabel(
+// Given a user-selected label, find the matching translated option and return
+// its original English label. If no match exists, OpenCode only gives us the
+// raw answer string, so treat non-empty text as a custom answer and translate
+// it through the same source-language -> English path as normal user messages.
+async function restoreLabel(
   selectedLabel: string,
   translatedOptions: readonly OptionRecord[],
   originalOptions: readonly OptionRecord[],
-): string {
+  options: RestoreQuestionOutputOptions,
+): Promise<string> {
   const idx = translatedOptions.findIndex((option) => option.label === selectedLabel)
-  if (idx < 0) return selectedLabel
-  return originalOptions[idx]?.label ?? selectedLabel
+  if (idx >= 0) return originalOptions[idx]?.label ?? selectedLabel
+  if (!options.translateCustomAnswer || selectedLabel.trim().length === 0) return selectedLabel
+
+  try {
+    const translated = await options.translateCustomAnswer(selectedLabel)
+    return unwrapEchoedTextEnvelope(translated)
+  } catch (error) {
+    await options.onTranslationError?.(error)
+    return selectedLabel
+  }
 }
 
 // Reconstruct the exact output string the question tool would have produced
 // if it had been called with the original English args. Mirrors the format
 // in `packages/opencode/src/tool/question.ts` (as of opencode 1.14.x).
-export function buildRestoredOutput(
+export async function buildRestoredOutput(
   original: readonly TextRecord[],
   translated: readonly TextRecord[],
   answers: readonly (readonly string[])[],
-): string {
-  const formatted = original
-    .map((q, i) => {
+  options: RestoreQuestionOutputOptions = {},
+): Promise<string> {
+  const formattedParts = await Promise.all(
+    original.map(async (q, i) => {
       const selected = answers[i] ?? []
       const translatedOptions = translated[i]?.options ?? []
       const originalOptions = q.options
-      const restored = selected.map((label) => restoreLabel(label, translatedOptions, originalOptions))
+      const restored = await Promise.all(
+        selected.map((label) => restoreLabel(label, translatedOptions, originalOptions, options)),
+      )
       const rendered = restored.length > 0 ? restored.join(", ") : "Unanswered"
       return `"${q.question}"="${rendered}"`
-    })
-    .join(", ")
+    }),
+  )
+  const formatted = formattedParts.join(", ")
   return `User has answered your questions: ${formatted}. You can now continue with the user's answers in mind.`
 }
 
-export function restoreQuestionOutput(output: QuestionToolOutput, snapshot: QuestionSnapshot): void {
+export async function restoreQuestionOutput(
+  output: QuestionToolOutput,
+  snapshot: QuestionSnapshot,
+  options: RestoreQuestionOutputOptions = {},
+): Promise<void> {
   if (typeof output.output !== "string") return
   const answersRaw = (output.metadata as { answers?: readonly (readonly string[])[] } | undefined)?.answers
   const answers = Array.isArray(answersRaw) ? answersRaw : []
-  output.output = buildRestoredOutput(snapshot.original, snapshot.translated, answers)
+  output.output = await buildRestoredOutput(snapshot.original, snapshot.translated, answers, options)
 }