opencode-ghost 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.3] - 2026-10-08
+
+### Fixed
+
+- **packaging:** Declare required OpenTUI runtime peers
+
+## [1.0.2] - 2026-10-08
+
+### Changed
+
+- **composer:** Remove redundant editor existence guard
+
+### Fixed
+
+- **lifecycle:** Bound recent completion deduplication history
+- **options:** Validate booleans and normalize accept bindings
+- **deps:** Align host and renderer compatibility requirements
+- **install:** Tolerate unrelated legacy configs and spaced paths
+- **composer:** Preserve navigation and rebound accept shortcuts
+- **model:** Anchor small-model provider on the session agent model
+- **model:** Match host title-model variant and default-provider fallback
+
 ## [1.0.1] - 2026-10-08
 
 ### Fixed
@@ -13,6 +35,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.0.0] - 2026-10-08
 
+### Added
+
+- `/suggest model provider/model` and `/suggest model clear` for persistent model overrides.
+- Effective title-agent model resolution and same-provider small-model selection.
+
+### Changed
+
+- Register TUI plugins by directory in `cli.json` instead of `tui.json`.
+
+### Removed
+
+- V1 inline typing ghosts and slash-command argument hints.
+- The `endpoint`, `apiKey`, `internalSessionMarkerDir`, and `argHints` options.
+
 ### Breaking changes
 
 - Migrate inline prompt ghosts to opencode v2 _(breaking)_
@@ -167,6 +203,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Options for `model`, `acceptKeys`, `maxChars`, `idleDelayMs`,
   `recentMessages` and `system`.
 
+[1.0.3]: https://github.com/ozandogrultan/opencode-ghost/compare/v1.0.2...v1.0.3
+[1.0.2]: https://github.com/ozandogrultan/opencode-ghost/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.6.0...v1.0.0
 [0.6.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.5.1...v0.6.0

package/README.md

@@ -20,8 +20,9 @@ a dimmed inline placeholder in the empty composer with
   dimmed placeholder only while the normal composer is empty and focused in an
   idle session. `Tab` or `→` inserts it as editable text; Enter does not accept
   or submit the ghost. Acceptance never replaces a draft or touches the clipboard.
-- **Clears as you type.** Typing anything other than an accept key dismisses
-  the suggestion.
+- **Clears as you type.** Text-editing keys and pasting dismiss the suggestion;
+  navigation keys leave it intact. Left on an empty eligible composer returns
+  home, even when suggestions are off (`backOnEmptyLeft`).
 - **`/suggest` toggles it.** State is stored durably via the plugin's storage.
 
 ## Requirements
@@ -106,11 +107,17 @@ and directory definitions such as `agents/title.md` and `agent/title.md`, includ
 agent deletion/recreation. Explicitly configured variants are preserved.
 Without a configured title model, or when the title agent is disabled, Ghost
 mirrors OpenCode 2.0.25's internal small-model policy until a public API exists:
-within the session model's provider (or the location's default provider), choose
+within the session model's provider (or the session agent model's provider,
+then the location's default provider, then the first enabled text model's
+provider when no default exists), choose
 the first enabled, active text-input/text-output catalog model in family order
 `gpt-luna`, `gemini-flash-lite`, `gemini-flash`, `claude-haiku`.
+Like OpenCode's title generation, an override, title or small model without a
+configured variant uses its first supported `none`, `minimal` or `low` variant.
 Catalog IDs are used directly. No matching small model means a warning and no
-suggestion; Ghost never falls back to the main model or another provider.
+suggestion. Ghost never uses the main model as a generation fallback or retries
+with another provider. An explicit override or configured title model may use
+a different provider from the session's primary model.
 
 When enabling, a suggestion is generated immediately for the current session.
 
@@ -167,7 +174,7 @@ When enabling, a suggestion is generated immediately for the current session.
 ```sh
 bun install
 bun run typecheck
-bun test
+bun run test
 ```
 
 No build step: like other opencode TUI plugins, the package ships TSX source and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ghost",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Stateless inline next-prompt ghosts for the empty OpenCode V2 composer, accepted with Tab or Right.",
   "type": "module",
   "license": "MIT",
@@ -36,7 +36,7 @@
   },
   "packageManager": "bun@1.4.2",
   "engines": {
-    "opencode": ">=2.0.0"
+    "opencode": ">=2.0.25"
   },
   "scripts": {
     "prepare": "husky",
@@ -47,21 +47,22 @@
     "lint:sh": "for script in install.sh tests/*.sh scripts/*.sh; do bash -n \"$script\" || exit; done",
     "prepublishOnly": "bun run test && bun run typecheck"
   },
-  "dependencies": {
-    "solid-js": "^1.9.12"
-  },
   "peerDependencies": {
     "@opencode/plugin": "*",
+    "@opentui/core": ">=0.5.16",
+    "@opentui/solid": ">=0.5.16",
     "solid-js": "*"
   },
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
     "@opencode/plugin": "2.0.25",
-    "@opentui/core": "^0.5.12",
-    "@opentui/solid": "^0.5.12",
+    "@opentui/core": "^0.5.16",
+    "@opentui/solid": "^0.5.16",
+    "@types/bun": "^1.4.2",
     "@types/node": "24.12.2",
     "husky": "^9.1.7",
+    "solid-js": "^1.9.12",
     "typescript": "7.0.2"
   }
 }

package/src/composer.ts

@@ -1,8 +1,15 @@
 import type { KeyEvent, KeyHandler, TextareaRenderable } from "@opentui/core"
 
+export function editsComposer(event: { name: string; sequence: string; ctrl: boolean; meta: boolean; option?: boolean; super?: boolean; hyper?: boolean }): boolean {
+  if (event.ctrl && !event.meta && !event.option && !event.super && !event.hyper) return ["v", "h", "d", "k", "u", "w", "j", "m"].includes(event.name)
+  if (event.ctrl || event.meta || event.option || event.super || event.hyper) return false
+  if (["return", "enter", "linefeed", "backspace", "delete", "space"].includes(event.name)) return true
+  return [...event.sequence].length === 1 && !/[\u0000-\u001f\u007f]/.test(event.sequence)
+}
+
 export function observeComposerInput(input: KeyHandler, preserve: (event: KeyEvent) => boolean, cancel: () => void): () => void {
   const onKeypress = (event: KeyEvent) => {
-    if (!preserve(event)) cancel()
+    if (editsComposer(event) && !preserve(event)) cancel()
   }
   input.prependListener("keypress", onKeypress)
   input.prependListener("paste", cancel)
@@ -31,7 +38,7 @@ export function isEmptyComposer(editor: TextareaRenderable | undefined, focused:
     !(node.id.startsWith("slot-layout-") && node.getChildren().length === 0),
   )
   if (siblings.length !== 2 || siblings[0] !== editor) return false
-  return !!editor && normal && mode === "base" && !selected && editor === focused && editor.focused && !editor.isDestroyed && editor.plainText === "" && !editor.hasSelection() && !editor.traits.capture?.includes("navigate") && editor.extmarks.getAll().length === 0
+  return normal && mode === "base" && !selected && editor === focused && editor.focused && !editor.isDestroyed && editor.plainText === "" && !editor.hasSelection() && !editor.traits.capture?.includes("navigate") && editor.extmarks.getAll().length === 0
 }
 
 export function findComposerEditor<T extends EditorNode>(marker: EditorNode | undefined, isEditor: (node: EditorNode) => node is T, isComposer: (editor: T) => boolean): T | undefined {

package/src/keymap.ts

@@ -1,4 +1,26 @@
 import type { KeymapCommand, KeymapLayer } from "@opencode/plugin/tui/context"
+import { canonicalKey } from "./composer"
+
+export const acceptCommandId = (key: string) => `ghost.accept.${key}`
+
+export function acceptCommand(key: string, session: () => string | undefined, suggestionSession: () => string | undefined, act: (sessionID: string) => boolean): KeymapCommand {
+  return {
+    id: acceptCommandId(key),
+    bind: key,
+    enabled: () => Boolean(suggestionSession()),
+    run: () => {
+      const sessionID = session()
+      if (!sessionID || suggestionSession() !== sessionID || !act(sessionID)) return false
+    },
+  }
+}
+
+export function acceptShortcuts(acceptKeys: readonly string[], shortcuts: (id: string) => readonly string[]): Set<string> {
+  return new Set(acceptKeys.flatMap((key) => {
+    const bound = shortcuts(acceptCommandId(key))
+    return bound.map(canonicalKey)
+  }))
+}
 
 export function ghostKeymapLayers(
   composerCommands: KeymapCommand[],

package/src/lifecycle.ts

@@ -28,6 +28,7 @@ export function createLifecycle(delay: number, allowed: (sessionID: string) => b
     succeeded(id: string, sessionID: string) {
       if (disposed || !allowed(sessionID) || completed.has(id)) return
       completed.add(id)
+      if (completed.size > COMPLETION_HISTORY_LIMIT) completed.delete(completed.values().next().value!)
       cancel()
       timer = setTimeout(() => { timer = undefined; void run(sessionID) }, delay)
     },
@@ -39,3 +40,4 @@ export function createLifecycle(delay: number, allowed: (sessionID: string) => b
     dispose() { disposed = true; cancel() },
   }
 }
+export const COMPLETION_HISTORY_LIMIT = 1024

package/src/options.ts

@@ -66,14 +66,14 @@ export function resolveOptions(options: Readonly<Record<string, unknown>> | unde
   const maxChars = input.maxChars
   const idleDelayMs = input.idleDelayMs
   const recentMessages = input.recentMessages
+  const acceptKeys = Array.isArray(input.acceptKeys)
+    ? [...new Set(input.acceptKeys.filter((key) => typeof key === "string" && key.trim() && key.trim().split("+").every((part) => part.trim())).map(canonicalKey))]
+    : []
   return {
-    enabled: input.enabled ?? DEFAULTS.enabled,
+    enabled: typeof input.enabled === "boolean" ? input.enabled : DEFAULTS.enabled,
     model: typeof input.model === "string" && input.model.trim() ? input.model.trim() : undefined,
-    acceptKeys:
-      Array.isArray(input.acceptKeys) && input.acceptKeys.length > 0
-        ? input.acceptKeys.filter((key) => typeof key === "string" && key.trim()).map(canonicalKey)
-        : [...DEFAULTS.acceptKeys],
-    backOnEmptyLeft: input.backOnEmptyLeft ?? DEFAULTS.backOnEmptyLeft,
+    acceptKeys: acceptKeys.length > 0 ? acceptKeys : [...DEFAULTS.acceptKeys],
+    backOnEmptyLeft: typeof input.backOnEmptyLeft === "boolean" ? input.backOnEmptyLeft : DEFAULTS.backOnEmptyLeft,
     maxChars: typeof maxChars === "number" && maxChars > 0 ? maxChars : DEFAULTS.maxChars,
     idleDelayMs:
       typeof idleDelayMs === "number" && idleDelayMs >= 0 ? idleDelayMs : DEFAULTS.idleDelayMs,

package/src/stateless.ts

@@ -12,14 +12,16 @@ export type GenerateClient = {
 export async function generateSuggestion(
   client: GenerateClient,
   prompt: string,
-  model: SuggestionModel | undefined,
+  model: SuggestionModel | undefined | Promise<SuggestionModel | undefined>,
   signal: AbortSignal,
   onError?: (error: unknown) => void,
+  allowed: () => boolean = () => true,
 ): Promise<string | undefined> {
-  if (signal.aborted || !model) return undefined
   try {
+    const resolved = await model
+    if (signal.aborted || !allowed() || !resolved) return undefined
     const result = await client.generate.text(
-      { prompt, model: { id: model.modelID, providerID: model.providerID, ...(model.variant ? { variant: model.variant } : {}) } },
+      { prompt, model: { id: resolved.modelID, providerID: resolved.providerID, ...(resolved.variant ? { variant: resolved.variant } : {}) } },
       { signal },
     )
     return result.text

package/src/text.ts

@@ -24,24 +24,55 @@ export async function resolveSmallModel(
   client: SmallModelClient,
   location: LocationRef,
   signal: AbortSignal,
-  providerID?: string,
+  session?: { model?: { providerID: string }; agent?: string },
 ): Promise<SuggestionModel | undefined> {
   if (signal.aborted) return undefined
   const agents = await client.agent.list({ location }, { signal })
   if (signal.aborted) return undefined
   const configured = agents.data.find((agent) => agent.id === "title")?.model
-  if (configured) return { providerID: configured.providerID, modelID: configured.id, ...(configured.variant ? { variant: configured.variant } : {}) }
-  if (!providerID) {
+  let providerID = session?.model?.providerID ?? (session?.agent ? agents.data.find((agent) => agent.id === session.agent)?.model?.providerID : undefined)
+  if (configured?.variant) return { providerID: configured.providerID, modelID: configured.id, variant: configured.variant }
+  if (!configured && !providerID) {
     const primary = await client.model.default({ location }, { signal })
     if (signal.aborted) return undefined
     providerID = primary.data?.providerID
   }
-  if (!providerID) throw new Error(NO_SMALL_MODEL)
   const catalog = await client.model.list({ location }, { signal })
   if (signal.aborted) return undefined
+  if (configured) {
+    const info = catalog.data.find((model) => model.providerID === configured.providerID && model.id === configured.id)
+    return withLowEffortVariant({ providerID: configured.providerID, modelID: configured.id }, info)
+  }
+  providerID ??= catalog.data.find((model) => model.enabled && isTextModel(model))?.providerID
+  if (!providerID) throw new Error(NO_SMALL_MODEL)
   const model = selectSmallModel(catalog.data, providerID)
   if (!model) throw new Error(NO_SMALL_MODEL)
-  return model
+  return withLowEffortVariant(model, catalog.data.find((info) => info.providerID === model.providerID && info.id === model.modelID))
+}
+
+export async function resolveExplicitModel(
+  client: Pick<SmallModelClient, "model">,
+  location: LocationRef,
+  signal: AbortSignal,
+  model: SuggestionModel,
+): Promise<SuggestionModel | undefined> {
+  if (signal.aborted) return undefined
+  if (model.variant) return model
+  const catalog = await client.model.list({ location }, { signal })
+  if (signal.aborted) return undefined
+  return withLowEffortVariant(model, catalog.data.find((info) => info.providerID === model.providerID && info.id === model.modelID))
+}
+
+const LOW_EFFORT_VARIANTS = ["none", "minimal", "low"]
+
+function withLowEffortVariant(model: SuggestionModel, info: ModelInfo | undefined): SuggestionModel {
+  const variant = LOW_EFFORT_VARIANTS.find((id) => info?.variants.some((item) => item.id === id))
+  return variant ? { ...model, variant } : model
+}
+
+function isTextModel(model: ModelInfo) {
+  const text = (items: readonly string[]) => items.length === 0 || items.some((item) => item.startsWith("text"))
+  return text(model.capabilities.input) && text(model.capabilities.output)
 }
 
 export function parseModel(spec: string | undefined): { providerID: string; modelID: string } | undefined {

package/src/tui.tsx

@@ -4,11 +4,11 @@ import { TextareaRenderable, InputRenderable, type BoxRenderable, type Renderabl
 import { createEffect, createRoot, createSignal, on, onCleanup } from "solid-js"
 import { composerAction, findComposerEditor, isEmptyComposer, keyName, observeComposerInput } from "./composer"
 import { createLifecycle } from "./lifecycle"
-import { ghostKeymapLayers } from "./keymap"
+import { acceptCommand, acceptShortcuts, ghostKeymapLayers } from "./keymap"
 import { parseSuggestCommand, removedOptionKeys, resolveOptions, suggestionModel } from "./options"
 import { createInlinePlaceholder } from "./placeholder"
 import { generateSuggestion } from "./stateless"
-import { isEcho, normalize, resolveSmallModel } from "./text"
+import { isEcho, normalize, resolveExplicitModel, resolveSmallModel } from "./text"
 import { buildTranscript, lastUserText, suggestionPrompt, type TranscriptMessage } from "./transcript"
 
 type Suggestion = { sessionID: string; text: string }
@@ -73,10 +73,11 @@ export default Plugin.define({
         if (!transcript) return
         const session = context.data.session.get(sessionID)
         const location = session?.location ?? context.location ?? context.data.location.default()
-        const model = suggestionModel(state.model, opts.model) ??
-          await resolveSmallModel(context.client, location, signal, session?.model?.providerID)
-        if (signal.aborted || !canGenerate(sessionID) || !model) return
-        const raw = await generateSuggestion(context.client, suggestionPrompt(opts.system, transcript), model, signal, warnGeneration)
+        const explicit = suggestionModel(state.model, opts.model)
+        const model = explicit
+          ? resolveExplicitModel(context.client, location, signal, explicit)
+          : resolveSmallModel(context.client, location, signal, session)
+        const raw = await generateSuggestion(context.client, suggestionPrompt(opts.system, transcript), model, signal, warnGeneration, () => canGenerate(sessionID))
         if (signal.aborted || !raw) return
         const clean = normalize(raw, opts.maxChars)
         if (!clean) return
@@ -151,22 +152,14 @@ export default Plugin.define({
       syncInline()
       const key = keyName(event)
       const current = suggestion()
-      return Boolean(current && inline.visible(getComposer(current.sessionID).editor, current.text) && opts.acceptKeys.includes(key) && canGenerate(current.sessionID) && isComposerEmpty(current.sessionID))
+      return Boolean(current && inline.visible(getComposer(current.sessionID).editor, current.text) && acceptShortcuts(opts.acceptKeys, context.keymap.shortcuts).has(key) && canGenerate(current.sessionID) && isComposerEmpty(current.sessionID))
     }, cancelSuggestion)
 
     const commandLayers = () => ghostKeymapLayers([
-        ...opts.acceptKeys.map((key) => ({
-          id: `ghost.accept.${key}`,
-          bind: key,
-          enabled: () => Boolean(suggestion()),
-          run: () => {
-            const route = context.ui.router.current()
-            if (route.type !== "session") return false
-            const current = suggestion()
-            if (!current || current.sessionID !== route.sessionID) return false
-            if (!act(route.sessionID)) return false
-          },
-        })),
+        ...opts.acceptKeys.map((key) => acceptCommand(key, () => {
+             const route = context.ui.router.current()
+             return route.type === "session" ? route.sessionID : undefined
+           }, () => suggestion()?.sessionID, act)),
         {
           id: "ghost.home",
           bind: "left",