opencode-queue 0.2.0 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 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.
+This plugin adds a real `/queue` slash command that keeps the current run focused instead of injecting your next message into the still-running loop.
 
 ## What it does
 
@@ -11,7 +11,9 @@ This plugin adds a `/queue ...` prefix that keeps the current run focused instea
 - Hides queued placeholders from both the UI transcript and the running agent
 - Replays queued input in order once the session becomes idle
 - Replays queued commands as a visible `/command` message before executing them
+- Registers `/queue` as a real OpenCode slash command
 - Shows the current queue with `/queue list`
+- Clears the current queue with `/queue clear`
 
 ## Install
 
@@ -36,6 +38,15 @@ While the agent is busy:
 /queue /review
 /queue /commit
 /queue list
+/queue clear
+```
+
+When the session is idle:
+
+```text
+/queue hello
+/queue /review
+/queue
 ```
 
 Queued items stay hidden while the current run is still working, then replay automatically when the session becomes idle.
@@ -44,8 +55,9 @@ Queued items stay hidden while the current run is still working, then replay aut
 
 - 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.
-- `/queue list` shows the in-memory queue for the current session.
+- Idle `/queue /command` immediately runs the nested command.
+- `/queue` and `/queue list` show the in-memory queue for the current session.
+- `/queue clear` drops all currently queued items for the current session.
 
 ## License
 

package/index.ts

@@ -10,10 +10,11 @@ import type {
 
 const QUEUE = /^\/queue(?:\s+([\s\S]*))?$/
 const COMMAND = /^\/(\S+)(?:\s+([\s\S]*))?$/
+const HANDLED = "__QUEUE_HANDLED__"
 
 type InputPart = TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput
 type Info = { agent: string; model: { providerID: string; modelID: string } }
-type Item = { info: Info; text: string; parts?: InputPart[]; command?: string; arguments?: string }
+type Item = { info: Info; text: string; parts?: InputPart[]; command?: string; arguments?: string; files?: FilePartInput[] }
 
 const label = (body: string, files: number) => {
   const text = body.trim() || `${files} attachment${files === 1 ? "" : "s"}`
@@ -53,6 +54,12 @@ export const QueuePlugin: Plugin = async ({ client }) => {
     return items.map((item, i) => `${i + 1}. ${item.text}`).join("\n")
   }
 
+  const clear = (sid: string) => {
+    const count = queue.get(sid)?.length ?? 0
+    queue.delete(sid)
+    return count ? `Cleared ${count} queued item${count === 1 ? "" : "s"}` : "Queue is empty"
+  }
+
   const replay = async (sid: string, item: Item) => {
     if (!item.command || item.arguments === undefined) {
       if (!item.parts?.length) {
@@ -77,7 +84,7 @@ export const QueuePlugin: Plugin = async ({ client }) => {
         agent: item.info.agent,
         model: item.info.model,
         noReply: true,
-        parts: [{ type: "text", text: item.text }],
+        parts: [{ type: "text", text: item.text }, ...(item.files ?? [])],
       },
     })
 
@@ -88,7 +95,8 @@ export const QueuePlugin: Plugin = async ({ client }) => {
         model: `${item.info.model.providerID}/${item.info.model.modelID}`,
         command: item.command,
         arguments: item.arguments,
-      },
+        parts: item.files,
+      } as any,
     })
   }
 
@@ -118,6 +126,13 @@ export const QueuePlugin: Plugin = async ({ client }) => {
   }
 
   return {
+    config: async (cfg) => {
+      cfg.command ??= {}
+      cfg.command.queue = {
+        template: "",
+        description: "Queue input until the session is idle",
+      }
+    },
     event: async ({ event }) => {
       if (event.type !== "session.status") return
 
@@ -130,6 +145,47 @@ export const QueuePlugin: Plugin = async ({ client }) => {
       busy.delete(sid)
       await flush(sid)
     },
+    "command.execute.before": async (input, output) => {
+      if (input.command !== "queue") return
+
+      const body = input.arguments ?? ""
+      const text = body.trim()
+      const files = output.parts.filter((part): part is FilePart => part.type === "file").map((part) => ({ ...part }))
+
+      if ((!text || text === "list" || text === "clear") && !files.length) {
+        await toast(text === "clear" ? clear(input.sessionID) : summary(input.sessionID), "info", 5000)
+        throw new Error(HANDLED)
+      }
+
+      if (!busy.has(input.sessionID)) {
+        const cmd = parseCommand(body)
+        if (!cmd) {
+          output.parts.length = 0
+          output.parts.push({ type: "text", text: body } as any, ...files)
+          return
+        }
+
+        await client.session.prompt({
+          path: { id: input.sessionID },
+          body: {
+            noReply: true,
+            parts: [{ type: "text", text }, ...files],
+          } as any,
+        })
+        await client.session.command({
+          path: { id: input.sessionID },
+          body: {
+            command: cmd.command,
+            arguments: cmd.arguments,
+            parts: files,
+          } as any,
+        })
+        throw new Error(HANDLED)
+      }
+
+      output.parts.length = 0
+      output.parts.push({ type: "text", text: `/queue ${body}` } as any, ...files)
+    },
     "chat.message": async ({ sessionID }, output) => {
       const text = output.parts.find((part): part is TextPart => part.type === "text" && !part.synthetic)
       if (!text) return
@@ -140,9 +196,9 @@ export const QueuePlugin: Plugin = async ({ client }) => {
       const files = output.parts.filter((part): part is FilePart => part.type === "file")
       const trimmed = body.trim()
 
-      if ((!trimmed || trimmed === "list") && !files.length) {
+      if ((!trimmed || trimmed === "list" || trimmed === "clear") && !files.length) {
         hide(output.message.id, text)
-        await toast(summary(sessionID), "info", 5000)
+        await toast(trimmed === "clear" ? clear(sessionID) : summary(sessionID), "info", 5000)
         return
       }
 
@@ -169,7 +225,9 @@ export const QueuePlugin: Plugin = async ({ client }) => {
 
       const info = { agent: output.message.agent, model: { ...output.message.model } }
       const command = parseCommand(body)
-      const item = command ? { info, text: trimmed, ...command } : { info, text: label(body, files.length), parts }
+      const item = command
+        ? { info, text: trimmed, files, ...command }
+        : { info, text: label(body, files.length), parts }
 
       enqueue(sessionID, item)
       hide(output.message.id, text)

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-queue",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Queue OpenCode prompts and slash commands until the agent is idle",
   "main": "./index.ts",