opencode-queue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mirsella
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# opencode-queue
+
+Queue OpenCode input until the current agent run is actually idle.
+
+This plugin adds a `/queue ...` prefix that keeps the current run focused instead of injecting your next message into the still-running loop.
+
+## What it does
+
+- Queues normal prompts entered while a session is busy
+- Queues slash commands like `/queue /review` and `/queue /commit`
+- Keeps queued placeholder messages visible in the UI
+- Filters queued placeholders out of model input so they do not interrupt the current run
+- Replays queued input in order once the session becomes idle
+
+## Install
+
+Add it to your OpenCode plugin list:
+
+```jsonc
+{
+  "plugin": ["opencode-queue"]
+}
+```
+
+OpenCode installs npm plugins automatically at startup.
+
+Restart OpenCode after installing.
+
+## Usage
+
+While the agent is busy:
+
+```text
+/queue continue after the current task finishes
+/queue /review
+/queue /commit
+```
+
+The queued message is shown as `[queued] ...` and is sent automatically when the current run becomes idle.
+
+## Notes
+
+- This is a `/queue` plugin, not a keyboard shortcut plugin. OpenCode plugins cannot currently register custom TUI keybindings.
+- Idle `/queue some text` is treated like a normal prompt with the `/queue` prefix removed.
+- Idle `/queue /command` is left alone and is not intercepted.
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,146 @@
+import type { Plugin } from "@opencode-ai/plugin"
+import type {
+  AgentPartInput,
+  FilePart,
+  FilePartInput,
+  SubtaskPartInput,
+  TextPart,
+  TextPartInput,
+} from "@opencode-ai/sdk"
+
+const QUEUE = /^\/queue(?:\s+([\s\S]*))?$/
+const COMMAND = /^\/(\S+)(?:\s+([\s\S]*))?$/
+
+type InputPart = TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput
+type Info = { agent: string; model: { providerID: string; modelID: string } }
+type Item = { info: Info; command: string; arguments: string } | { info: Info; parts: InputPart[] }
+
+const label = (body: string, files: number) => {
+  const text = body.trim() || `${files} attachment${files === 1 ? "" : "s"}`
+  return text.length > 72 ? `${text.slice(0, 69)}...` : text
+}
+
+const parseCommand = (body: string) => {
+  const match = body.trim().match(COMMAND)
+  return match ? { command: match[1], arguments: match[2] ?? "" } : undefined
+}
+
+const QueuePlugin: Plugin = async ({ client }) => {
+  const queue = new Map<string, Item[]>()
+  const hidden = new Set<string>()
+  const busy = new Set<string>()
+  const flushing = new Set<string>()
+
+  const toast = (message: string, variant: "info" | "error") =>
+    client.tui.showToast({ body: { message, variant, duration: 2500 } }).catch(() => undefined)
+
+  const flush = async (sid: string) => {
+    if (flushing.has(sid)) return
+
+    const list = queue.get(sid)
+    if (!list?.length) return
+
+    flushing.add(sid)
+
+    try {
+      while (list.length) {
+        const item = list.shift()
+        if (!item) break
+
+        if ("command" in item) {
+          await client.session.command({
+            path: { id: sid },
+            body: {
+              agent: item.info.agent,
+              model: `${item.info.model.providerID}/${item.info.model.modelID}`,
+              command: item.command,
+              arguments: item.arguments,
+            },
+          })
+          continue
+        }
+
+        await client.session.prompt({
+          path: { id: sid },
+          body: {
+            agent: item.info.agent,
+            model: item.info.model,
+            parts: item.parts.map((part) => ({ ...part, id: undefined })),
+          },
+        })
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error)
+      console.error("QueuePlugin failed to flush queued input", error)
+      await toast(`Queue failed: ${message}`, "error")
+    } finally {
+      if (list.length) queue.set(sid, list)
+      else queue.delete(sid)
+      flushing.delete(sid)
+    }
+  }
+
+  return {
+    event: async ({ event }) => {
+      if (event.type !== "session.status") return
+
+      const sid = event.properties.sessionID
+      if (event.properties.status.type !== "idle") {
+        busy.add(sid)
+        return
+      }
+
+      busy.delete(sid)
+      await flush(sid)
+    },
+    "chat.message": async ({ sessionID }, output) => {
+      const text = output.parts.find((part): part is TextPart => part.type === "text" && !part.synthetic)
+      if (!text) return
+
+      const body = text.text.match(QUEUE)?.[1]
+      if (body === undefined) return
+
+      const files = output.parts.filter((part): part is FilePart => part.type === "file")
+      if (!body.trim() && !files.length) return
+
+      if (!busy.has(sessionID)) {
+        if (body.trimStart().startsWith("/")) return
+        text.text = body
+        return
+      }
+
+      const parts = output.parts.flatMap((part): InputPart[] => {
+        switch (part.type) {
+          case "text":
+            if (part.id !== text.id) return [{ ...part }]
+            return body ? [{ ...part, text: body }] : []
+          case "file":
+          case "agent":
+          case "subtask":
+            return [{ ...part }]
+          default:
+            console.warn("QueuePlugin skipped unexpected part", part.type)
+            return []
+        }
+      })
+
+      const info = { agent: output.message.agent, model: { ...output.message.model } }
+      const command = parseCommand(body)
+      const item = command ? { info, ...command } : { info, parts }
+      const list = queue.get(sessionID)
+      if (list) list.push(item)
+      else queue.set(sessionID, [item])
+
+      const note = label(body, files.length)
+      hidden.add(output.message.id)
+      text.text = `[queued] ${note}`
+      await toast(`Queued: ${note}`, "info")
+    },
+    "experimental.chat.messages.transform": async (_, output) => {
+      output.messages = output.messages.filter((msg) => !hidden.has(msg.info.id))
+    },
+  }
+}
+
+export { QueuePlugin }
+export default QueuePlugin

package/package.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "opencode-queue",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Queue OpenCode prompts and slash commands until the agent is idle",
+  "main": "./index.ts",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugin",
+    "queue"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mirsella/opencode-queue.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mirsella/opencode-queue/issues"
+  },
+  "homepage": "https://github.com/mirsella/opencode-queue#readme",
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "latest",
+    "@opencode-ai/sdk": "latest",
+    "typescript": "^5.9.3"
+  }
+}