opencode-ghost 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-09-25
+
+### Changed
+
+- All ghosts (next-message suggestion and typing completions) render inside
+  the prompt box at the caret; the prompt's hint row (status line) is left
+  alone in every state.
+- Typing ghosts are positioned from absolute screen coordinates (the prompt
+  editor's `screenX/screenY` plus the caret's visual column/row) instead of a
+  relative slot offset, and clear reliably when the input no longer matches.
+- `GHOST_DEBUG=1` makes the plugin emit diagnostic toasts about ghost
+  placement (temporary, for localization feedback).
 ## [0.2.1] - 2026-09-24
 
 ### Changed
@@ -66,7 +78,8 @@ 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.2.1...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.2...HEAD
+[0.2.2]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.1.0...v0.1.1

package/README.md

@@ -116,8 +116,9 @@ When enabling, a suggestion is generated immediately for the current session.
   survives the server's automatic title generation, and a periodic sweep (plus
   shutdown cleanup) reaps any leftovers — including sessions orphaned by a
   crash — with no configuration required.
-- Renders the result through the `session_prompt` host slot into the prompt's
-  `hint` row, and accepts it into the input via the prompt ref.
+- Renders the result through the `session_prompt` host slot, ghosted inside
+  the prompt box at the caret, and accepts it into the input via the prompt
+  ref.
 
 ## Caveats
 
@@ -125,13 +126,10 @@ When enabling, a suggestion is generated immediately for the current session.
   through that slot, so this plugin replaces the default prompt component. It
   forwards `on_submit`, `ref`, `right`, `visible`, and `disabled`, and cannot be
   combined with another plugin that also renders `session_prompt`.
-- **Ghost placement.** Typing ghosts are drawn directly into the prompt
-  buffer after the caret (opencode exposes no inline-completion API, so the
-  plugin overlays the prompt's editor renderable). When the layout cannot be
-  located, they fall back to the prompt's hint row. The next-prompt
-  suggestion always uses the hint row.
-- **`hint` row.** While a suggestion is showing it occupies the prompt's hint
-  row, so the working-directory label is hidden until you accept or type.
+- **Ghost placement.** All ghosts (next-message suggestion, typing
+  completions) render inside the prompt box right after the caret; opencode
+  exposes no inline-completion API, so the plugin overlays the prompt's
+  editor renderable and never touches the prompt's hint row.
 - **Cost.** One small-model call per turn while enabled. Point `model` at a
   cheap or free model.
 - **`acceptKeys`.** `tab` is also opencode's agent-cycle key; this plugin only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ghost",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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",

package/src/tui.tsx

@@ -19,6 +19,7 @@ const MAX_MESSAGE_CHARS = 800
 const MAX_TRANSCRIPT_CHARS = 6000
 const ENABLED_KEY = "ghost.enabled"
 const MODEL_KEY = "ghost.model"
+const GHOST_DEBUG = Boolean(process.env.GHOST_DEBUG)
 
 const HIDDEN_TOOLS = {
   bash: false,
@@ -336,29 +337,15 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     return undefined
   }
 
-  // In-box ghost: the suggestion is drawn directly into the prompt's text area
-  // right after the caret, refreshed each frame. When the text area cannot be
-  // located (host layout change), completion falls back to the hint row.
-  let inBoxGhost: { x: number; y: number; text: string } | undefined
-  const drawGhost = (buffer: unknown) => {
-    const target = inBoxGhost
-    if (!target) return
-    try {
-      const drawn = buffer as { drawText?: (text: string, x: number, y: number, fg: unknown) => void }
-      drawn.drawText?.(target.text, target.x, target.y, api.theme.current.textMuted)
-    } catch {
-      // Rendering must never fail because of the overlay.
-    }
-  }
-  const postProcesses = (api.renderer as unknown as { postProcessFns?: unknown[] } | undefined)
-    ?.postProcessFns
-  if (Array.isArray(postProcesses)) postProcesses.push(drawGhost)
-  const removeOverlay = () => {
-    if (!postProcesses) return
-    const index = postProcesses.indexOf(drawGhost)
-    if (index >= 0) postProcesses.splice(index, 1)
-  }
-
+  // In-box ghost: an absolutely positioned text node rendered in the slot's
+  // own container, at the caret of the prompt's editor renderable (found by
+  // walking the layout tree). Uses the normal render pipeline, so it is visible
+  // wherever the prompt is. When the editor or container cannot be located
+  // (host layout change) completion falls back to the hint row.
+  const [inBox, setInBox] = createSignal<
+    { sessionID: string; x: number; y: number; text: string } | undefined
+  >()
+  let slotNode: { screenX?: number; screenY?: number } | undefined
   // Locate the prompt's editor renderable inside the layout tree.
   const findTextarea = (): unknown => {
     const root = (api.renderer as unknown as { root?: unknown }).root as
@@ -385,8 +372,8 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     return undefined
   }
 
-  const placeInBoxGhost = (text: string): boolean => {
-    inBoxGhost = undefined
+  const placeInBoxGhost = (sessionID: string, text: string): boolean => {
+    setInBox(undefined)
     const textarea = findTextarea() as
       | { screenX?: unknown; screenY?: unknown; visualCursor?: { visualRow?: number; visualCol?: number } }
       | undefined
@@ -398,22 +385,31 @@ const tui: TuiPlugin = async (api, rawOptions) => {
       return false
     }
     const cursor = textarea.visualCursor ?? {}
-    inBoxGhost = {
-      x: textarea.screenX + (typeof cursor.visualCol === "number" ? cursor.visualCol : 0),
-      y: textarea.screenY + (typeof cursor.visualRow === "number" ? cursor.visualRow : 0),
-      text,
+    // Overlay coordinates are relative to the slot container (it anchors the
+    // absolute overlay), so subtract its screen origin from the editor's.
+    if (
+      !slotNode ||
+      typeof slotNode.screenX !== "number" ||
+      typeof slotNode.screenY !== "number"
+    ) {
+      return false
     }
+    const x = textarea.screenX - slotNode.screenX + (typeof cursor.visualCol === "number" ? cursor.visualCol : 0)
+    const y = textarea.screenY - slotNode.screenY + (typeof cursor.visualRow === "number" ? cursor.visualRow : 0)
+    setInBox({ sessionID, x, y, text })
     return true
   }
 
   const POLL_INTERVAL_MS = 100
   const POOL_TTL_MS = 60_000
   let completionKey = ""
-  const pollTimer = setInterval(() => {
+    const pollTimer = setInterval(() => {
     const sessionID = currentSessionID()
     if (!sessionID) {
-      inBoxGhost = undefined
-      if (completion()) setCompletion(undefined)
+      if (completion() || inBox()) {
+        setCompletion(undefined)
+        setInBox(undefined)
+      }
       return
     }
     const input = promptRef?.current.input ?? ""
@@ -425,18 +421,37 @@ const tui: TuiPlugin = async (api, rawOptions) => {
       : input.includes(" ")
         ? completeCommand(input, commandPool, opts.argHints)
         : undefined
-    const key = `${sessionID}\u0000${input}`
-    const insert = found?.insert ?? ""
-    if (completionKey === `${key}\u0000${insert}`) return
-    completionKey = `${key}\u0000${insert}`
     let display = ""
+    let insert = ""
     if (found) {
       const args = "args" in found ? found.args : undefined
       const hint = "hint" in found ? found.hint : undefined
+      insert = found.insert ?? ""
       display = args && args.length > 0 ? `[${args.join(" | ")}]` : (found.ghost ?? hint ?? "")
+    } else if (!input.trim()) {
+      // Empty prompt: the model's next-message suggestion is ghosted in the
+      // box as well (the accept layer's `accept()` handles Tab for it).
+      const next = ghost()
+      if (next && next.sessionID === sessionID) display = next.text
+    }
+    // Include the display in the key: a fresh suggestion for an unchanged
+    // (empty) input must still be re-placed.
+    const key = `${sessionID}\u0000${input}\u0000${display}`
+    if (completionKey === key) return
+    completionKey = key
+    const drawn = display ? placeInBoxGhost(sessionID, display) : false
+    if (!drawn) setInBox(undefined)
+    if (GHOST_DEBUG && (display || input.startsWith("/"))) {
+      const overlay = inBox()
+      try {
+        api.ui.toast({
+          title: "ghost-debug",
+          message: `display=${display.slice(0, 20) || "∅"} drawn=${drawn} slot=${slotNode ? `${slotNode.screenX}/${slotNode.screenY}` : "n"} box=${overlay ? `${overlay.x}/${overlay.y}` : "∅"}`,
+        })
+      } catch {
+        // ignore
+      }
     }
-    inBoxGhost = undefined
-    const drawn = display ? placeInBoxGhost(display) : false
     setCompletion(
       found
         ? {
@@ -696,42 +711,39 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     order: 60,
     slots: {
       session_prompt(_ctx, props) {
-        const suggestion = () => {
-          const current = ghost()
-          return current && current.sessionID === props.session_id ? current.text : ""
-        }
-        const completionText = () => {
-          const current = completion()
-          if (!current || current.sessionID !== props.session_id) return ""
-          // In in-box mode `drawGhost` handles the text; the hint row then stays free.
-          if (current.drawn) return ""
-          return current.display
+        const overlay = () => {
+          const current = inBox()
+          return current && current.sessionID === props.session_id ? current : undefined
         }
         return (
-          <api.ui.Prompt
-            sessionID={props.session_id}
-            visible={props.visible}
-            disabled={props.disabled}
-            showPlaceholder={false}
-            hint={
-              suggestion() || completionText() ? (
-                <box marginLeft={1}>
-                  <text fg={api.theme.current.textMuted}>
-                    {completionText() || suggestion()}
-                  </text>
-                </box>
-              ) : undefined
-            }
-            right={<api.ui.Slot name="session_prompt_right" session_id={props.session_id} />}
-            onSubmit={() => {
-              showGhost(undefined)
-              props.on_submit?.()
-            }}
-            ref={(ref) => {
-              promptRef = ref
-              props.ref?.(ref)
+          <box
+            position="relative"
+            ref={(ref: { screenX?: number; screenY?: number }) => {
+              slotNode = ref
             }}
-          />
+          >
+            <api.ui.Prompt
+              sessionID={props.session_id}
+              visible={props.visible}
+              disabled={props.disabled}
+              showPlaceholder={false}
+              right={<api.ui.Slot name="session_prompt_right" session_id={props.session_id} />}
+              onSubmit={() => {
+                showGhost(undefined)
+                setInBox(undefined)
+                props.on_submit?.()
+              }}
+              ref={(ref) => {
+                promptRef = ref
+                props.ref?.(ref)
+              }}
+            />
+            {overlay() ? (
+              <box position="absolute" left={overlay()!.x} top={overlay()!.y} zIndex={100}>
+                <text fg={api.theme.current.textMuted}>{overlay()!.text}</text>
+              </box>
+            ) : undefined}
+          </box>
         )
       },
     },
@@ -769,7 +781,7 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     if (timer) clearTimeout(timer)
     clearInterval(sweepTimer)
     clearInterval(pollTimer)
-    removeOverlay()
+    setInBox(undefined)
     offIdle()
     offStatus()
     backLayer()