opencode-groq-dictate 1.1.7 → 1.1.8

package/README.md

@@ -72,12 +72,20 @@ clone out of `~/.config/opencode/plugins/` before installing from npm.
 | `ctrl+click` on the same two | same as `ctrl+alt+v` |
 | `esc` | cancel the take: no upload, no request, no cost |
 | `/dictate` | same as `alt+v`, from the command palette |
+| `⚙` next to the title | open the settings panel |
 
 A take stops on its own after 60 seconds. Everything else is in the palette under
 **Voice**: `Dictate (Groq) and submit`, `Dictation model`, `Dictation language`,
-`Dictation quota`.
+`Dictation quota`, `Dictation settings`.
 
-Both bindings are ordinary commands, so you can rebind or disable them in
+The `⚙` panel (or `Dictation settings` in the palette) holds the four things worth
+changing: the two shortcuts, the model and the language. Click a row, write the new
+value, and it applies at once — the keymap layer reads the stored config, so a new
+combination works without restarting OpenCode. A blank shortcut disables the key but
+leaves the command in the palette. `model` and `language` open the same pickers as the
+palette commands.
+
+The shortcuts are ordinary commands, so you can also rebind or disable them in
 `cli.json` without touching the plugin:
 
 ```jsonc

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-groq-dictate",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Groq dictation in the OpenCode v2 TUI: alt+v records, transcribes with whisper-large-v3-turbo, and pastes the text into the prompt.",
   "private": false,
   "type": "module",

package/src/voice.test.ts

@@ -2,6 +2,7 @@ import { expect, test } from "bun:test"
 import {
   DEFAULT_MODEL,
   audioSeconds,
+  bindOf,
   cost,
   logLine,
   parseConfig,
@@ -32,19 +33,43 @@ test("the rpm window drops stamps older than a minute", () => {
 })
 
 test("a config with the wrong types falls back to the defaults", () => {
-  expect(parseConfig(null)).toEqual({ apiKey: "", language: "it", model: DEFAULT_MODEL })
+  expect(parseConfig(null)).toEqual({
+    apiKey: "",
+    language: "it",
+    model: DEFAULT_MODEL,
+    bindStart: "alt+v",
+    bindSubmit: "ctrl+alt+v",
+  })
   expect(parseConfig({ apiKey: 42, language: "", model: "nope" })).toEqual({
     apiKey: "",
     language: "it",
     model: DEFAULT_MODEL,
+    bindStart: "alt+v",
+    bindSubmit: "ctrl+alt+v",
   })
-  expect(parseConfig({ apiKey: "gsk_x", language: "auto", model: "whisper-large-v3" })).toEqual({
+  expect(
+    parseConfig({
+      apiKey: "gsk_x",
+      language: "auto",
+      model: "whisper-large-v3",
+      bindStart: "alt+d",
+      bindSubmit: "",
+    }),
+  ).toEqual({
     apiKey: "gsk_x",
     language: "auto",
     model: "whisper-large-v3",
+    bindStart: "alt+d",
+    // An empty bind is meaningful: the command stays in the palette, the key goes away.
+    bindSubmit: "",
   })
 })
 
+test("an empty bind becomes false for the keymap", () => {
+  expect(bindOf("alt+v")).toBe("alt+v")
+  expect(bindOf("  ")).toBe(false)
+})
+
 test("the cost line keeps the shell script's four columns", () => {
   expect(logLine(new Date(2026, 9, 19, 8, 5, 3), 12.34, 0.000137)).toBe("2026-10-19 08:05:03 12.3 0.000137")
   expect(logLine(new Date(2026, 9, 19, 8, 5, 3), 12.34, 0.000137, "whisper-large-v3")).toBe(

package/src/voice.ts

@@ -20,20 +20,43 @@ export const BYTES_PER_SAMPLE = 2
 // parec writes a canonical 44-byte header; anything past it is audio.
 export const WAV_HEADER = 44
 
-export type Config = { apiKey: string; language: string; model: Model }
+export type Config = {
+  apiKey: string
+  language: string
+  model: Model
+  // Empty means "no binding": the command stays in the palette, the key does nothing.
+  bindStart: string
+  bindSubmit: string
+}
 
-export const DEFAULTS: Config = { apiKey: "", language: "it", model: DEFAULT_MODEL }
+export const DEFAULTS: Config = {
+  apiKey: "",
+  language: "it",
+  model: DEFAULT_MODEL,
+  bindStart: "alt+v",
+  bindSubmit: "ctrl+alt+v",
+}
 
 export function parseConfig(raw: unknown): Config {
   const value = (raw ?? {}) as Record<string, unknown>
   const model = MODELS.includes(value.model as Model) ? (value.model as Model) : DEFAULTS.model
+  // Binds are free text: an empty string is meaningful (disabled), a missing key is not.
+  const bind = (key: "bindStart" | "bindSubmit") =>
+    typeof value[key] === "string" ? (value[key] as string) : DEFAULTS[key]
   return {
     apiKey: typeof value.apiKey === "string" ? value.apiKey : DEFAULTS.apiKey,
     language: typeof value.language === "string" && value.language ? value.language : DEFAULTS.language,
     model,
+    bindStart: bind("bindStart"),
+    bindSubmit: bind("bindSubmit"),
   }
 }
 
+// The keymap wants `false` to disable a binding, not an empty string.
+export function bindOf(value: string): string | false {
+  return value.trim() || false
+}
+
 export function audioSeconds(bytes: number): number {
   return Math.max(0, bytes - WAV_HEADER) / (SAMPLE_RATE * BYTES_PER_SAMPLE)
 }

package/tui.tsx

@@ -11,6 +11,7 @@ import {
   MODELS,
   RPM_LIMIT,
   audioSeconds,
+  bindOf,
   cost,
   logLine,
   parseConfig,
@@ -256,8 +257,8 @@ export default Plugin.define({
       }, MAX_SECONDS * 1000)
       context.ui.toast.show({
         message: submit
-          ? "Recording… ctrl+alt+v stops and sends · esc cancels"
-          : "Recording… alt+v stop · esc cancel",
+          ? `Recording… ${settings().bindSubmit || "the palette"} stops and sends · esc cancels`
+          : `Recording… ${settings().bindStart || "the palette"} stops · esc cancels`,
         variant: "info",
         duration: 2000,
       })
@@ -330,6 +331,57 @@ export default Plugin.define({
       context.ui.toast.show({ message: `Language: ${settings().language}`, variant: "success" })
     }
 
+    // One panel for the four things a user changes: the two shortcuts, the model
+    // and the language. Each row reopens the panel after writing, because the
+    // dialog body renders once and its labels would otherwise stay stale.
+    const settingsRow = (label: string, value: string, onClick: () => void) => (
+      <box flexDirection="row" onMouseUp={onClick}>
+        <text>{(label + "  ").padEnd(18)}</text>
+        <text fg={accent()}>{value}</text>
+      </box>
+    )
+
+    function openSettings() {
+      const current = settings()
+      context.ui.dialog.clear()
+      context.ui.dialog.show(() => (
+        <box flexDirection="column" paddingLeft={1} paddingRight={1}>
+          <text fg={accent()}>{"Groq dictation"}</text>
+          <text fg={muted()}>{"click a row: changes apply at once"}</text>
+          {settingsRow("start / stop", current.bindStart || "disabled", () =>
+            editBind("bindStart", "Start and stop"),
+          )}
+          {settingsRow("start and send", current.bindSubmit || "disabled", () =>
+            editBind("bindSubmit", "Start, stop and send"),
+          )}
+          {settingsRow("model", current.model.replace("whisper-", ""), () => change(pickModel))}
+          {settingsRow("language", current.language, () => change(pickLanguage))}
+        </box>
+      ))
+      context.ui.dialog.set({ size: "large", centered: true })
+    }
+
+    // The panel closes before a prompt can open, then comes back with the new value.
+    async function change(action: () => Promise<void>) {
+      context.ui.dialog.clear()
+      await action()
+      openSettings()
+    }
+
+    async function editBind(key: "bindStart" | "bindSubmit", title: string) {
+      context.ui.dialog.clear()
+      const value = await context.ui.dialog.prompt({
+        title: `${title} (blank disables the key)`,
+        placeholder: settings()[key] || "e.g. alt+v",
+        value: settings()[key],
+      })
+      if (value !== undefined)
+        await updateConfig((draft) => {
+          draft[key] = value.trim()
+        })
+      openSettings()
+    }
+
     context.keymap.layer(() => ({
       mode: "global",
       priority: 10,
@@ -340,7 +392,8 @@ export default Plugin.define({
           group: "Voice",
           // Not super+v: VTE only enables xterm modifyOtherKeys, which never
           // reports the Super modifier, so that binding could not fire here.
-          bind: "alt+v",
+          // Read from the stored config, so changing it in the panel rebinds now.
+          bind: bindOf(settings().bindStart),
           palette: true,
           slash: { name: "dictate" },
           run: () => toggle(),
@@ -351,7 +404,7 @@ export default Plugin.define({
           group: "Voice",
           // ctrl+alt is what modifyOtherKeys reports, the same path the TUI's own
           // ctrl+alt defaults take. Rebind or disable it in cli.json like any other.
-          bind: "ctrl+alt+v",
+          bind: bindOf(settings().bindSubmit),
           palette: true,
           run: () => toggle(true),
         },
@@ -388,6 +441,13 @@ export default Plugin.define({
           palette: true,
           run: pickModel,
         },
+        {
+          id: "opencode-groq-dictate.settings",
+          title: "Dictation settings",
+          group: "Voice",
+          palette: true,
+          run: openSettings,
+        },
       ],
       bindings: [
         "opencode-groq-dictate.toggle",
@@ -450,9 +510,14 @@ export default Plugin.define({
         const state = () => (recording() ? red() : busy() ? amber() : green())
         return (
           <box flexDirection="column">
-            <text fg={muted()} onMouseUp={(event) => toggle(wantsSubmit(event))}>
-              {"🎤 Groq Dictate"}
-            </text>
+            <box flexDirection="row" gap={1}>
+              <text fg={muted()} onMouseUp={(event) => toggle(wantsSubmit(event))}>
+                {"🎤 Groq Dictate"}
+              </text>
+              <text fg={muted()} onMouseUp={() => openSettings()}>
+                {"⚙"}
+              </text>
+            </box>
             {row(
               "state",
               recording() ? `● rec ${elapsed()}s` : busy() ? "transcribing…" : "idle",