@bybrawe/opencode-loop 0.5.11 → 0.5.13

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.5.13
+
+- Wrapped experimental goal tools with `tool()` and Zod schemas for current OpenCode tool validation.
+- Added `@opencode-ai/plugin` as a dev dependency so fresh clones can resolve the tool helper during local development.
+
+## 0.5.12
+
+- Fixed local plugin installs to write `opencode-loop.ts`, matching OpenCode local plugin discovery.
+- Removed stale `opencode-loop.js` local plugin copies during install to avoid duplicate or outdated local plugin loads.
+- Made the PowerShell source installer honor `OPENCODE_CONFIG_DIR`, matching the npm and shell installers.
+- Fixed `opencode-loopd` to pass the prompt to `opencode run` as the positional message instead of the non-existent `--prompt` flag.
+- Added a short retry backoff for failing `opencode-loopd --every 0s` runs.
+- Normalized command arguments from array/object forms so `opencode run --command loop ...` can schedule jobs like TUI slash commands.
+- Stripped whole-argument quote wrappers before parsing loop durations, fixing quoted `opencode run --command loop "1h ..."` invocations.
+- Fixed a goal finalization reassignment so the generated local TypeScript plugin parses under Bun.
+- Fixed the Windows Task Scheduler helper script path used by `opencode-loopd install-task`.
+- Tried current OpenCode SDK `{ path, body }` and `{ query }` argument shapes before older fallback shapes.
+
 ## 0.5.11
 
 - Added a watchdog loop in addition to one-shot due timers, so recurring jobs keep checking due work even if OpenCode misses an idle event or a due timeout gets effectively stuck behind a stale busy state.

package/README.md

@@ -178,18 +178,19 @@ npx -y @bybrawe/opencode-loop
 ```
 
 The installer copies the plugin and slash command files into your OpenCode config directory.
+It also removes the old local `opencode-loop.js` copy from earlier releases so only the current local `opencode-loop.ts` plugin remains.
 
 Windows target paths:
 
 ```text
-%USERPROFILE%\.config\opencode\plugins\opencode-loop.js
+%USERPROFILE%\.config\opencode\plugins\opencode-loop.ts
 %USERPROFILE%\.config\opencode\commands\loop*.md
 ```
 
 macOS / Linux target paths:
 
 ```text
-~/.config/opencode/plugins/opencode-loop.js
+~/.config/opencode/plugins/opencode-loop.ts
 ~/.config/opencode/commands/loop*.md
 ```
 
@@ -273,7 +274,7 @@ Windows PowerShell:
 ```powershell
 mkdir "$env:USERPROFILE\.config\opencode\plugins" -Force
 mkdir "$env:USERPROFILE\.config\opencode\commands" -Force
-copy .\src\index.js "$env:USERPROFILE\.config\opencode\plugins\opencode-loop.js"
+copy .\src\index.js "$env:USERPROFILE\.config\opencode\plugins\opencode-loop.ts"
 copy .\commands\*.md "$env:USERPROFILE\.config\opencode\commands\"
 ```
 
@@ -281,7 +282,7 @@ macOS / Linux:
 
 ```bash
 mkdir -p ~/.config/opencode/plugins ~/.config/opencode/commands
-cp ./src/index.js ~/.config/opencode/plugins/opencode-loop.js
+cp ./src/index.js ~/.config/opencode/plugins/opencode-loop.ts
 cp ./commands/*.md ~/.config/opencode/commands/
 ```
 
@@ -291,7 +292,7 @@ Use this when you want the plugin to be available only inside one repository.
 
 ```bash
 mkdir -p .opencode/plugins .opencode/commands
-cp ./src/index.js .opencode/plugins/opencode-loop.js
+cp ./src/index.js .opencode/plugins/opencode-loop.ts
 cp ./commands/*.md .opencode/commands/
 ```
 
@@ -300,7 +301,7 @@ On Windows PowerShell:
 ```powershell
 mkdir .opencode\plugins -Force
 mkdir .opencode\commands -Force
-copy .\src\index.js .opencode\plugins\opencode-loop.js
+copy .\src\index.js .opencode\plugins\opencode-loop.ts
 copy .\commands\*.md .opencode\commands\
 ```
 
@@ -316,7 +317,7 @@ After restarting OpenCode, run:
 If the commands do not appear:
 
 1. Make sure OpenCode was fully restarted.
-2. Check that `opencode-loop.js` exists in the OpenCode plugin directory.
+2. Check that `opencode-loop.ts` exists in the OpenCode plugin directory.
 3. Check that `loop.md`, `loop-help.md`, and the other command files exist in the OpenCode commands directory.
 4. Run `npx -y @bybrawe/opencode-loop` again to reinstall the command files.
 
@@ -1177,4 +1178,4 @@ Improve the application in small safe steps.
 
 ## License
 
-MIT
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bybrawe/opencode-loop",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "description": "Claude Code/Codex style /loop and experimental goal mode for OpenCode: heartbeat scheduler, idle-safe loops, scheduled commands, compact scheduling, verification, checkpoints, and persistent coding goals.",
   "type": "module",
   "main": "src/index.js",
@@ -54,9 +54,12 @@
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.4.0"
   },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.4.0"
+  },
   "bin": {
-    "opencode-loop": "./scripts/install-node.mjs",
-    "opencode-loopd": "./scripts/loopd.mjs"
+    "opencode-loop": "scripts/install-node.mjs",
+    "opencode-loopd": "scripts/loopd.mjs"
   },
   "publishConfig": {
     "access": "public"

package/scripts/install-node.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { copyFile, mkdir, readdir } from "node:fs/promises"
+import { copyFile, mkdir, readdir, rm } from "node:fs/promises"
 import { homedir } from "node:os"
 import { dirname, join } from "node:path"
 import { fileURLToPath } from "node:url"
@@ -11,7 +11,8 @@ const commandDir = join(config, "commands")
 
 await mkdir(pluginDir, { recursive: true })
 await mkdir(commandDir, { recursive: true })
-await copyFile(join(root, "src", "index.js"), join(pluginDir, "opencode-loop.js"))
+await copyFile(join(root, "src", "index.js"), join(pluginDir, "opencode-loop.ts"))
+await rm(join(pluginDir, "opencode-loop.js"), { force: true })
 
 for (const name of await readdir(join(root, "commands"))) {
   if (name.endsWith(".md")) {

package/scripts/install.ps1

@@ -1,6 +1,6 @@
 $ErrorActionPreference = "Stop"
 
-$ConfigDir = Join-Path $env:USERPROFILE ".config\opencode"
+$ConfigDir = if ($env:OPENCODE_CONFIG_DIR) { $env:OPENCODE_CONFIG_DIR } else { Join-Path $env:USERPROFILE ".config\opencode" }
 $PluginDir = Join-Path $ConfigDir "plugins"
 $CommandDir = Join-Path $ConfigDir "commands"
 $Root = Split-Path -Parent $PSScriptRoot
@@ -8,10 +8,11 @@ $Root = Split-Path -Parent $PSScriptRoot
 New-Item -ItemType Directory -Force -Path $PluginDir | Out-Null
 New-Item -ItemType Directory -Force -Path $CommandDir | Out-Null
 
-Copy-Item -Force (Join-Path $Root "src\index.js") (Join-Path $PluginDir "opencode-loop.js")
+Copy-Item -Force (Join-Path $Root "src\index.js") (Join-Path $PluginDir "opencode-loop.ts")
+Remove-Item -Force -ErrorAction SilentlyContinue (Join-Path $PluginDir "opencode-loop.js")
 Copy-Item -Force (Join-Path $Root "commands\*.md") $CommandDir
 
 Write-Host "Installed OpenCode Loop plugin." -ForegroundColor Green
-Write-Host "Plugin:   $PluginDir\opencode-loop.js"
+Write-Host "Plugin:   $PluginDir\opencode-loop.ts"
 Write-Host "Commands: $CommandDir\loop*.md"
 Write-Host "Restart OpenCode, then run: /loop-help"

package/scripts/install.sh

@@ -7,10 +7,11 @@ COMMAND_DIR="$CONFIG_DIR/commands"
 ROOT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
 
 mkdir -p "$PLUGIN_DIR" "$COMMAND_DIR"
-cp "$ROOT_DIR/src/index.js" "$PLUGIN_DIR/opencode-loop.js"
+cp "$ROOT_DIR/src/index.js" "$PLUGIN_DIR/opencode-loop.ts"
+rm -f "$PLUGIN_DIR/opencode-loop.js"
 cp "$ROOT_DIR/commands"/*.md "$COMMAND_DIR/"
 
 echo "Installed OpenCode Loop plugin."
-echo "Plugin:   $PLUGIN_DIR/opencode-loop.js"
+echo "Plugin:   $PLUGIN_DIR/opencode-loop.ts"
 echo "Commands: $COMMAND_DIR/loop*.md"
 echo "Restart OpenCode, then run: /loop-help"

package/scripts/loopd.mjs

@@ -2,8 +2,10 @@
 import fs from "node:fs"
 import path from "node:path"
 import { spawn, spawnSync } from "node:child_process"
+import { fileURLToPath } from "node:url"
 
 const args = process.argv.slice(2)
+const FAILED_RUN_RETRY_MS = 5_000
 
 function arg(name, fallback = null) {
   const i = args.indexOf(name)
@@ -97,11 +99,14 @@ async function daemon() {
     console.log("")
     console.log(`[opencode-loopd] run #${count} ${new Date().toISOString()}`)
 
-    const command = `opencode run --continue --prompt ${JSON.stringify(prompt)}`
+    const command = `opencode run --continue ${JSON.stringify(prompt)}`
     const code = await run(command, project)
 
     if (code !== 0) {
       console.log(`[opencode-loopd] opencode exited with code ${code}`)
+      if (delay === 0) {
+        await sleep(FAILED_RUN_RETRY_MS)
+      }
     }
 
     if (maxRuns > 0 && count >= maxRuns) {
@@ -127,7 +132,7 @@ function installTask() {
   const promptFile = arg("--prompt-file")
   const promptArg = arg("--prompt")
   const node = process.execPath
-  const script = path.resolve(new URL(import.meta.url).pathname)
+  const script = fileURLToPath(import.meta.url)
 
   const commandParts = [
     `"${node}"`,

package/src/index.js

@@ -1,6 +1,7 @@
 import { promises as fs } from "node:fs"
 import path from "node:path"
 import { spawn } from "node:child_process"
+import { tool } from "@opencode-ai/plugin/tool"
 
 const SERVICE = "opencode-loop"
 const STATE_DIR = ".opencode/opencode-loop"
@@ -148,7 +149,7 @@ function parseCompactEvery(value) {
 }
 
 function parseLoopArgs(raw, defaults = {}) {
-  let input = String(raw || "").trim()
+  let input = stripOuterQuotes(String(raw || "").trim())
   let first = ""
   let rest = input
   let intervalMs = defaults.intervalMs ?? null
@@ -390,8 +391,8 @@ async function executeTuiCommand(client, command) {
   if (!client?.tui?.executeCommand) throw new Error("client.tui.executeCommand is not available")
   return await sdkCall(
     client.tui.executeCommand.bind(client.tui),
-    { command },
     { body: { command } },
+    { command },
   )
 }
 
@@ -415,7 +416,7 @@ async function compactSession(client, sessionID) {
     }
   }
   try {
-    await sdkCall(client.session.summarize.bind(client.session), { sessionID }, { path: { id: sessionID }, body: {} })
+    await sdkCall(client.session.summarize.bind(client.session), { path: { id: sessionID }, body: {} }, { sessionID })
     return true
   } catch (error) {
     await log(client, "warn", "session.summarize fallback failed", { error: sdkErrorMessage(error) })
@@ -428,22 +429,22 @@ async function log(client, level, message, extra) {
   try {
     await sdkCall(
       client.app.log.bind(client.app),
-      extra === undefined ? { service: SERVICE, level, message } : { service: SERVICE, level, message, extra },
       { body: extra === undefined ? { service: SERVICE, level, message } : { service: SERVICE, level, message, extra } },
+      extra === undefined ? { service: SERVICE, level, message } : { service: SERVICE, level, message, extra },
     )
   } catch {}
 }
 
 async function toast(client, message, variant = "info") {
-  try { await sdkCall(client.tui.showToast.bind(client.tui), { message, variant }, { body: { message, variant } }) } catch {}
+  try { await sdkCall(client.tui.showToast.bind(client.tui), { body: { message, variant } }, { message, variant }) } catch {}
 }
 
 async function say(client, sessionID, text) {
   try {
     await sdkCall(
       client.session.prompt.bind(client.session),
-      { sessionID, noReply: true, parts: [{ type: "text", text }] },
       { path: { id: sessionID }, body: { noReply: true, parts: [{ type: "text", text }] } },
+      { sessionID, noReply: true, parts: [{ type: "text", text }] },
     )
   } catch {}
 }
@@ -468,6 +469,18 @@ function normalizeArgsForKey(args) {
   try { return JSON.stringify(args) } catch { return String(args) }
 }
 
+function commandArgsText(args) {
+  if (args === undefined || args === null) return ""
+  if (typeof args === "string") return args
+  if (Array.isArray(args)) return args.map(commandArgsText).join(" ")
+  if (typeof args === "object") {
+    for (const key of ["arguments", "args", "message", "text", "value"]) {
+      if (args[key] !== undefined) return commandArgsText(args[key])
+    }
+  }
+  return String(args)
+}
+
 function rememberSession(directory, client, sessionID) {
   if (!sessionID) return
   knownSessions.set(sessionID, { directory, client, seenAt: now() })
@@ -809,7 +822,7 @@ function staleActiveRun(sessionID) {
 
 async function readLiveSessionStatus(client, sessionID, directory) {
   const argsList = []
-  if (directory) argsList.push({ workspace: directory }, { directory })
+  if (directory) argsList.push({ query: { directory } }, { workspace: directory }, { directory })
   argsList.push({})
   for (const args of argsList) {
     try {
@@ -1140,7 +1153,7 @@ async function finalizeActiveRun(directory, client, sessionID) {
   if (!active) return
   clearActiveRun(sessionID)
   const state = await readState(directory, sessionID)
-  const job = (state.jobs || []).find((candidate) => candidate.id === active.jobId)
+  let job = (state.jobs || []).find((candidate) => candidate.id === active.jobId)
   if (!job) return
   job.lastFinishedAt = now()
 
@@ -1209,7 +1222,7 @@ async function fireAction(directory, client, sessionID, job) {
       await compactSession(client, sessionID)
       return { startsAssistantTurn: true }
     }
-    await sdkCall(client.session.command.bind(client.session), { sessionID, command, arguments: argumentsText }, { path: { id: sessionID }, body: { command, arguments: argumentsText } })
+    await sdkCall(client.session.command.bind(client.session), { path: { id: sessionID }, body: { command, arguments: argumentsText } }, { sessionID, command, arguments: argumentsText })
     return { startsAssistantTurn: true }
   }
   if (kind === "shell") {
@@ -1219,18 +1232,18 @@ async function fireAction(directory, client, sessionID, job) {
       await appendLoopLog(directory, "blocked", { sessionID, job: job.name || job.id, command })
       return { startsAssistantTurn: false }
     }
-    fireSdk(client, "session.shell", client.session.shell.bind(client.session), { sessionID, command }, { path: { id: sessionID }, body: { command } })
+    fireSdk(client, "session.shell", client.session.shell.bind(client.session), { path: { id: sessionID }, body: { command } }, { sessionID, command })
     return { startsAssistantTurn: true }
   }
   const prompt = await buildPrompt(directory, job)
   const prefix = kind === "goal"
     ? "EXPERIMENTAL GOAL MODE CONTINUATION. Continue pursuing the active goal. Do not explain the /loop-goal command. Use the goal tools only when progress/completion/block state is real."
     : "AUTONOMOUS OPENCODE LOOP ITERATION. Continue the configured task now. Do not explain the /loop command. Do not search for documentation about this plugin. Do not create scheduler files. Do not ask questions. Make reasonable assumptions and work directly."
-  fireSdk(client, "session.prompt", client.session.prompt.bind(client.session), { sessionID, parts: [{ type: "text", text: `${prefix}
+  fireSdk(client, "session.prompt", client.session.prompt.bind(client.session), { path: { id: sessionID }, body: { parts: [{ type: "text", text: `${prefix}
 
-${prompt}` }] }, { path: { id: sessionID }, body: { parts: [{ type: "text", text: `${prefix}
+${prompt}` }] } }, { sessionID, parts: [{ type: "text", text: `${prefix}
 
-${prompt}` }] } })
+${prompt}` }] })
   return { startsAssistantTurn: true }
 }
 
@@ -1346,7 +1359,7 @@ async function maybeRunDueJobs(directory, client, sessionID, options = {}) {
         return
       }
       let timer
-      if (job.timeoutMs > 0) timer = setTimeout(() => { fireSdk(client, "session.abort", client.session.abort.bind(client.session), { sessionID }, { path: { id: sessionID }, body: {} }); toast(client, `Loop timeout fired: ${job.name || job.id}`, "warning").catch(() => {}) }, job.timeoutMs)
+      if (job.timeoutMs > 0) timer = setTimeout(() => { fireSdk(client, "session.abort", client.session.abort.bind(client.session), { path: { id: sessionID }, body: {} }, { sessionID }); toast(client, `Loop timeout fired: ${job.name || job.id}`, "warning").catch(() => {}) }, job.timeoutMs)
       activeRuns.set(sessionID, { jobId: job.id, job, startedAt: now(), timer })
       await reschedule(BUSY_RETRY_MS)
     } catch (error) {
@@ -1588,7 +1601,7 @@ async function exportLoop(directory, client, sessionID) {
 async function handleCommand(directory, client, input, fallbackName, fallbackArgs, output) {
   const name = commandName(input?.command ?? input?.name ?? fallbackName)
   const sessionID = input?.sessionID
-  const args = input?.arguments ?? fallbackArgs ?? ""
+  const args = commandArgsText(input?.arguments ?? fallbackArgs ?? "")
   if (!sessionID || !name) return false
   rememberSession(directory, client, sessionID)
   if (wasHandled(sessionID, name, args)) return true
@@ -1628,39 +1641,39 @@ async function handleCommand(directory, client, input, fallbackName, fallbackArg
 
 function goalTools(defaultDirectory) {
   return {
-    opencode_loop_goal_complete: {
+    opencode_loop_goal_complete: tool({
       description: "Mark the current OpenCode Loop experimental goal as completed. Use only after acceptance criteria are satisfied and you have evidence from tests, typecheck, build, or code inspection.",
       args: {
-        summary: { type: "string", description: "Short human-readable summary of what was completed." },
-        evidence: { type: "string", description: "Concrete evidence that the goal is complete, such as commands run, passing checks, files changed, and important results." },
+        summary: tool.schema.string().describe("Short human-readable summary of what was completed."),
+        evidence: tool.schema.string().describe("Concrete evidence that the goal is complete, such as commands run, passing checks, files changed, and important results."),
       },
       execute: async (args, context) => {
         const result = await setGoalComplete(context.directory || defaultDirectory, context.sessionID, args)
         return { title: result.ok ? "Goal completed" : "Goal not found", output: result.message }
       },
-    },
-    opencode_loop_goal_blocked: {
+    }),
+    opencode_loop_goal_blocked: tool({
       description: "Mark the current OpenCode Loop experimental goal as blocked when user input or manual intervention is required.",
       args: {
-        reason: { type: "string", description: "Why the goal is blocked." },
-        needed: { type: "string", description: "What user input, credential, decision, or manual action is needed to continue." },
+        reason: tool.schema.string().describe("Why the goal is blocked."),
+        needed: tool.schema.string().describe("What user input, credential, decision, or manual action is needed to continue."),
       },
       execute: async (args, context) => {
         const result = await setGoalBlocked(context.directory || defaultDirectory, context.sessionID, args)
         return { title: result.ok ? "Goal blocked" : "Goal not found", output: result.message }
       },
-    },
-    opencode_loop_goal_progress: {
+    }),
+    opencode_loop_goal_progress: tool({
       description: "Record meaningful progress on the current OpenCode Loop experimental goal without completing it.",
       args: {
-        summary: { type: "string", description: "What useful progress was made." },
-        next: { type: "string", description: "The next step toward completing the goal." },
+        summary: tool.schema.string().describe("What useful progress was made."),
+        next: tool.schema.string().describe("The next step toward completing the goal."),
       },
       execute: async (args, context) => {
         const result = await setGoalProgress(context.directory || defaultDirectory, context.sessionID, args)
         return { title: result.ok ? "Goal progress" : "Goal not found", output: result.message }
       },
-    },
+    }),
   }
 }