opencode-ghost 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-09-30
+
+### Added
+
+- Support `--all` and explicit directory targets in `install.sh` to install across both global OpenCode v1 (`~/.config/opencode`) and sandbox/v2 configurations.
+
+### Fixed
+
+- Support OpenCode v1 and v2 plugin loading conventions (named and default `tui`/`id` exports, snake_case and camelCase slot props, object model specs).
+## [0.4.0] - 2026-09-30
+
+### Added
+
+- Expanded direct stateless suggestion generation: resolve API keys directly from OpenCode provider state (`api.state.provider`), add default endpoints for well-known providers (OpenAI, DeepSeek, Groq, Mistral, OpenRouter, Together, Ollama, Perplexity, xAI, Fireworks, Cerebras), and support keyless local completions without creating temporary OpenCode sessions.
 ## [0.3.1] - 2026-09-28
 
 ### Fixed
@@ -132,7 +146,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Options for `model`, `acceptKeys`, `maxChars`, `idleDelayMs`,
   `recentMessages` and `system`.
 
-[Unreleased]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.3.1...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.7...v0.3.0
 [0.2.7]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.6...v0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ghost",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Claude Code-style next-prompt suggestions in the opencode TUI, shown as dimmed ghost text and accepted with Tab. An opencode plugin.",
   "type": "module",
   "license": "MIT",
@@ -63,6 +63,6 @@
     "@opentui/solid": "0.4.5",
     "@types/node": "24.12.2",
     "husky": "^9.1.7",
-    "typescript": "5.8.2"
+    "typescript": "7.0.2"
   }
 }

package/src/stateless.ts

@@ -3,6 +3,34 @@ import * as os from "node:os"
 import * as path from "node:path"
 import type { ResolvedOptions } from "./options"
 
+const WELL_KNOWN_BASE_URLS: Record<string, string> = {
+  openai: "https://api.openai.com/v1",
+  deepseek: "https://api.deepseek.com",
+  groq: "https://api.groq.com/openai/v1",
+  mistral: "https://api.mistral.com/v1",
+  openrouter: "https://openrouter.ai/api/v1",
+  together: "https://api.together.xyz/v1",
+  ollama: "http://127.0.0.1:11434/v1",
+  perplexity: "https://api.perplexity.ai",
+  xai: "https://api.x.ai/v1",
+  fireworks: "https://api.fireworks.ai/inference/v1",
+  cerebras: "https://api.cerebras.ai/v1",
+}
+
+const WELL_KNOWN_ENV_KEYS: Record<string, string[]> = {
+  openai: ["OPENAI_API_KEY"],
+  deepseek: ["DEEPSEEK_API_KEY"],
+  groq: ["GROQ_API_KEY"],
+  mistral: ["MISTRAL_API_KEY"],
+  openrouter: ["OPENROUTER_API_KEY"],
+  together: ["TOGETHER_API_KEY"],
+  perplexity: ["PERPLEXITY_API_KEY"],
+  xai: ["XAI_API_KEY"],
+  fireworks: ["FIREWORKS_API_KEY"],
+  cerebras: ["CEREBRAS_API_KEY"],
+  anthropic: ["ANTHROPIC_API_KEY"],
+}
+
 export function resolveApiKey(raw: string | undefined): string | undefined {
   if (!raw) return undefined
   const trimmed = raw.trim()
@@ -24,24 +52,70 @@ export function resolveApiKey(raw: string | undefined): string | undefined {
   return trimmed
 }
 
+function resolveProviderApiKey(
+  opts: ResolvedOptions,
+  providerID: string | undefined,
+  providerConfig: any,
+  providerState: any,
+): string | undefined {
+  if (opts.apiKey) return resolveApiKey(opts.apiKey)
+
+  const configKey = resolveApiKey(providerConfig?.options?.apiKey)
+  if (configKey) return configKey
+
+  const stateOptionKey = resolveApiKey(providerState?.options?.apiKey)
+  if (stateOptionKey) return stateOptionKey
+
+  const stateKey = resolveApiKey(providerState?.key)
+  if (stateKey) return stateKey
+
+  if (Array.isArray(providerState?.env)) {
+    for (const envName of providerState.env) {
+      if (typeof envName === "string" && process.env[envName]) {
+        return process.env[envName]
+      }
+    }
+  }
+
+  if (providerID && WELL_KNOWN_ENV_KEYS[providerID]) {
+    for (const envName of WELL_KNOWN_ENV_KEYS[providerID]) {
+      if (process.env[envName]) {
+        return process.env[envName]
+      }
+    }
+  }
+
+  if (process.env.LITELLM_API_KEY) return process.env.LITELLM_API_KEY
+  if (!providerID || providerID === "openai" || providerID === "custom") {
+    if (process.env.OPENAI_API_KEY) return process.env.OPENAI_API_KEY
+  }
+
+  return undefined
+}
+
 export async function fetchStatelessSuggestion(
   transcript: string,
   opts: ResolvedOptions,
   modelRef: { providerID: string; modelID: string } | undefined,
   config: any,
+  providers?: readonly any[],
 ): Promise<string | undefined> {
-  const provider = modelRef?.providerID ? config?.provider?.[modelRef.providerID] : undefined
+  const providerID = modelRef?.providerID
+  const providerConfig = providerID ? config?.provider?.[providerID] : undefined
+  const providerState = providerID && Array.isArray(providers)
+    ? providers.find((p) => p?.id === providerID)
+    : undefined
+
+  const apiKey = resolveProviderApiKey(opts, providerID, providerConfig, providerState)
+  const isAnthropic = providerID === "anthropic"
+
   const baseURL =
     opts.endpoint ||
-    provider?.options?.baseURL ||
+    providerConfig?.options?.baseURL ||
+    providerState?.options?.baseURL ||
+    (!isAnthropic && providerID ? WELL_KNOWN_BASE_URLS[providerID] : undefined) ||
     process.env.LITELLM_BASE_URL ||
     process.env.OPENAI_BASE_URL
-  const rawKey =
-    opts.apiKey ||
-    provider?.options?.apiKey ||
-    process.env.LITELLM_API_KEY ||
-    process.env.OPENAI_API_KEY
-  const apiKey = resolveApiKey(rawKey)
 
   const controller = new AbortController()
   const timeoutMs = 4000
@@ -54,7 +128,8 @@ export async function fetchStatelessSuggestion(
         : `${baseURL.replace(/\/+$/, "")}/chat/completions`
 
       const rawModel = modelRef?.modelID || "default"
-      const model = rawModel.includes("/")
+      const keepSlash = providerID === "openrouter" || providerID === "together"
+      const model = !keepSlash && rawModel.includes("/")
         ? rawModel.slice(rawModel.lastIndexOf("/") + 1)
         : rawModel
 
@@ -82,9 +157,15 @@ export async function fetchStatelessSuggestion(
     }
 
     if (modelRef?.providerID === "anthropic") {
-      const antKey = resolveApiKey(provider?.options?.apiKey) || process.env.ANTHROPIC_API_KEY
+      const antKey = apiKey || process.env.ANTHROPIC_API_KEY
       if (!antKey) return undefined
-      const res = await fetch("https://api.anthropic.com/v1/messages", {
+      const antBase = (
+        providerConfig?.options?.baseURL ||
+        providerState?.options?.baseURL ||
+        "https://api.anthropic.com"
+      ).replace(/\/+$/, "")
+      const url = antBase.endsWith("/v1/messages") ? antBase : `${antBase}/v1/messages`
+      const res = await fetch(url, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",

package/src/text.ts

@@ -1,7 +1,27 @@
 export function parseModel(
-  spec: string | undefined,
+  spec: unknown,
 ): { providerID: string; modelID: string } | undefined {
   if (!spec) return undefined
+  if (typeof spec === "object" && spec !== null) {
+    const obj = spec as Record<string, unknown>
+    const providerID =
+      typeof obj.providerID === "string"
+        ? obj.providerID
+        : typeof obj.provider === "string"
+          ? obj.provider
+          : undefined
+    const modelID =
+      typeof obj.modelID === "string"
+        ? obj.modelID
+        : typeof obj.id === "string"
+          ? obj.id
+          : typeof obj.model === "string"
+            ? obj.model
+            : undefined
+    if (providerID && modelID) return { providerID, modelID }
+    return undefined
+  }
+  if (typeof spec !== "string") return undefined
   const index = spec.indexOf("/")
   if (index <= 0 || index === spec.length - 1) return undefined
   return { providerID: spec.slice(0, index), modelID: spec.slice(index + 1) }

package/src/tui.tsx

@@ -562,10 +562,11 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     } catch {
       // ignore
     }
+    const config = api.state.config as Record<string, unknown> | undefined
     return (
       parseModel(opts.model) ??
-      parseModel(api.state.config.small_model) ??
-      parseModel(api.state.config.model)
+      parseModel(config?.small_model ?? config?.smallModel) ??
+      parseModel(config?.model)
     )
   }
 
@@ -631,6 +632,7 @@ const tui: TuiPlugin = async (api, rawOptions) => {
       opts,
       model,
       api.state.config,
+      api.state.provider,
     )
     if (stateless) {
       const suggestion = normalize(stateless, opts.maxChars)
@@ -828,9 +830,10 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     order: 60,
     slots: {
       session_prompt(_ctx, props) {
+        const sid = props.session_id ?? (props as any).sessionID
         const overlay = () => {
           const current = inBox()
-          return current && current.sessionID === props.session_id ? current : undefined
+          return current && current.sessionID === sid ? current : undefined
         }
         return (
           <box
@@ -840,15 +843,16 @@ const tui: TuiPlugin = async (api, rawOptions) => {
             }}
           >
             <api.ui.Prompt
-              sessionID={props.session_id}
+              sessionID={sid}
               visible={props.visible}
               disabled={props.disabled}
               showPlaceholder={false}
-              right={<api.ui.Slot name="session_prompt_right" session_id={props.session_id} />}
+              right={<api.ui.Slot name="session_prompt_right" session_id={sid} />}
               onSubmit={() => {
                 showGhost(undefined)
                 setInBox(undefined)
                 props.on_submit?.()
+                ;(props as any).onSubmit?.()
               }}
               ref={(ref) => {
                 promptRef = ref
@@ -930,7 +934,6 @@ const tui: TuiPlugin = async (api, rawOptions) => {
   })
 }
 
-export default {
-  id: "ghost",
-  tui,
-}
+export const id = "ghost"
+export { tui }
+export default Object.assign(tui, { id: "ghost", tui })