@prevalentware/opencode-goal-plugin 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prevalentware/opencode-goal-plugin",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "OpenCode goal plugin that adds Codex-style long-running goal mode, /goal commands, persistence, and TUI status for AI coding agents.",
   "keywords": [
     "opencode",
@@ -53,14 +53,14 @@
     "prepublishOnly": "bun run test && bun run build"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.14.39",
+    "@opencode-ai/plugin": "^1.17.1",
     "effect": "^3.21.2",
     "zod": "^4.1.8"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@opentui/core": "^0.2.2",
-    "@opentui/solid": "^0.2.2",
+    "@opentui/core": "^0.4.0",
+    "@opentui/solid": "^0.4.0",
     "@types/bun": "^1.3.13",
     "eslint": "^10.3.0",
     "solid-js": "1.9.12",
@@ -68,7 +68,7 @@
     "typescript-eslint": "^8.59.2"
   },
   "engines": {
-    "opencode": ">=1.14.0"
+    "opencode": ">=1.17.1"
   },
   "publishConfig": {
     "access": "public"

package/src/tui.tsx

@@ -1,11 +1,22 @@
 /** @jsxImportSource @opentui/solid */
-import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui"
+import type { TuiCommand, TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui"
 import { createMemo, createSignal, onCleanup, Show } from "solid-js"
 
+type GoalCheckpoint = {
+  summary: string
+  timestamp: number
+}
+
+type GoalHistoryEntry = {
+  type: string
+  detail: string
+  timestamp: number
+}
+
 type GoalSnapshot = {
   sessionID: string
   objective: string
-  status: "active" | "paused" | "budgetLimited" | "complete" | "unmet"
+  status: "active" | "paused" | "budgetLimited" | "usageLimited" | "complete" | "unmet"
   tokenBudget: number | null
   tokensUsed: number
   timeUsedSeconds: number
@@ -16,6 +27,18 @@ type GoalSnapshot = {
   closedAt?: number | null
   continuationFailures: number
   lastStatus: string | null
+  maxAutoTurns: number | null
+  maxDurationSeconds: number | null
+  noProgressTokenThreshold: number | null
+  maxNoProgressTurns: number | null
+  noProgressTurns: number
+  budgetWrapupSent: boolean
+  stopReason: string | null
+  history: GoalHistoryEntry[]
+  checkpoints: GoalCheckpoint[]
+  lastCheckpoint: GoalCheckpoint | null
+  lastAssistantText: string
+  lastAssistantMessageID: string
   autoTurns: number
   lastContinuationAt: number | null
   remainingTokens: number | null
@@ -41,6 +64,22 @@ type GoalSessionState = {
   messageIndex: number
 }
 
+type ModernTuiApi = TuiPluginApi & {
+  keymap?: {
+    registerLayer?: (layer: {
+      commands: {
+        namespace: string
+        name: string
+        title: string
+        desc?: string
+        category?: string
+        run?: () => void
+      }[]
+      bindings?: unknown[]
+    }) => () => void
+  }
+}
+
 const goalCache = new Map<string, GoalSnapshot>()
 
 function currentSessionID(api: TuiPluginApi) {
@@ -69,31 +108,45 @@ function clearGoalPrompt() {
   return "Clear the current session goal by calling clear_goal. Report whether a goal was cleared."
 }
 
+function pauseGoalPrompt() {
+  return 'Pause the current session goal by calling update_goal_status with status "paused". Report the result briefly.'
+}
+
+function resumeGoalPrompt() {
+  return 'Resume the current session goal by calling update_goal_status with status "active", then continue working toward it.'
+}
+
+function historyGoalPrompt() {
+  return "Call get_goal_history for this session and report the current goal history briefly."
+}
+
+function actionOption(api: TuiPluginApi, sessionID: string, title: string, value: string, description: string, prompt: string) {
+  return {
+    title,
+    value,
+    description,
+    onSelect: () => {
+      void sendGoalPrompt(api, sessionID, prompt)
+        .then(() => api.ui.dialog.clear())
+        .catch((error) => toast(api, error instanceof Error ? error.message : String(error), "error"))
+    },
+  }
+}
+
 function showSummary(api: TuiPluginApi, sessionID: string, goal: GoalSnapshot | null) {
   const DialogSelect = api.ui.DialogSelect
   const options = [
-    {
-      title: "Refresh",
-      value: "refresh",
-      description: "Ask the agent to read the current goal state",
-      onSelect: () => {
-        void sendGoalPrompt(api, sessionID, refreshGoalPrompt())
-          .then(() => api.ui.dialog.clear())
-          .catch((error) => toast(api, error instanceof Error ? error.message : String(error), "error"))
-      },
-    },
+    actionOption(api, sessionID, "Refresh", "refresh", "Ask the agent to read the current goal state", refreshGoalPrompt()),
     ...(goal
       ? [
-          {
-            title: "Clear",
-            value: "clear",
-            description: "Ask the agent to clear this session goal",
-            onSelect: () => {
-              void sendGoalPrompt(api, sessionID, clearGoalPrompt())
-                .then(() => api.ui.dialog.clear())
-                .catch((error) => toast(api, error instanceof Error ? error.message : String(error), "error"))
-            },
-          },
+          actionOption(api, sessionID, "History", "history", "Ask the agent to show lifecycle history", historyGoalPrompt()),
+          ...(goal.status === "active"
+            ? [actionOption(api, sessionID, "Pause", "pause", "Pause auto-continuation without clearing", pauseGoalPrompt())]
+            : []),
+          ...(goal.status === "paused" || goal.status === "budgetLimited" || goal.status === "usageLimited"
+            ? [actionOption(api, sessionID, "Resume", "resume", "Resume the goal and continue", resumeGoalPrompt())]
+            : []),
+          actionOption(api, sessionID, "Clear", "clear", "Ask the agent to clear this session goal", clearGoalPrompt()),
         ]
       : []),
   ]
@@ -137,7 +190,7 @@ function currentEpochSeconds() {
 
 export function liveTimeUsedSeconds(goal: GoalSnapshot, nowSeconds = currentEpochSeconds()) {
   const baseSeconds = Math.max(0, Math.floor(goal.timeUsedSeconds))
-  if (visibleStatus(goal.status) !== "active") return baseSeconds
+  if (goal.status !== "active") return baseSeconds
   if (typeof goal.sampledAt !== "number") return baseSeconds
   return baseSeconds + Math.max(0, Math.floor(nowSeconds - goal.sampledAt))
 }
@@ -146,11 +199,19 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null
 }
 
+function isCheckpoint(value: unknown): value is GoalCheckpoint {
+  return isRecord(value) && typeof value.summary === "string" && typeof value.timestamp === "number"
+}
+
+function isHistoryEntry(value: unknown): value is GoalHistoryEntry {
+  return isRecord(value) && typeof value.type === "string" && typeof value.detail === "string" && typeof value.timestamp === "number"
+}
+
 function isGoalSnapshot(value: unknown): value is GoalSnapshot {
   if (!isRecord(value)) return false
   if (typeof value.sessionID !== "string") return false
   if (typeof value.objective !== "string") return false
-  if (!["active", "paused", "budgetLimited", "complete", "unmet"].includes(String(value.status))) return false
+  if (!["active", "paused", "budgetLimited", "usageLimited", "complete", "unmet"].includes(String(value.status))) return false
   if (value.tokenBudget !== null && typeof value.tokenBudget !== "number") return false
   if (typeof value.tokensUsed !== "number") return false
   if (typeof value.timeUsedSeconds !== "number") return false
@@ -161,6 +222,18 @@ function isGoalSnapshot(value: unknown): value is GoalSnapshot {
   if (value.closedAt != null && typeof value.closedAt !== "number") return false
   if (typeof value.continuationFailures !== "number") return false
   if (value.lastStatus != null && typeof value.lastStatus !== "string") return false
+  if (value.maxAutoTurns !== null && typeof value.maxAutoTurns !== "number") return false
+  if (value.maxDurationSeconds !== null && typeof value.maxDurationSeconds !== "number") return false
+  if (value.noProgressTokenThreshold !== null && typeof value.noProgressTokenThreshold !== "number") return false
+  if (value.maxNoProgressTurns !== null && typeof value.maxNoProgressTurns !== "number") return false
+  if (typeof value.noProgressTurns !== "number") return false
+  if (typeof value.budgetWrapupSent !== "boolean") return false
+  if (value.stopReason !== null && typeof value.stopReason !== "string") return false
+  if (!Array.isArray(value.history) || !value.history.every(isHistoryEntry)) return false
+  if (!Array.isArray(value.checkpoints) || !value.checkpoints.every(isCheckpoint)) return false
+  if (value.lastCheckpoint !== null && !isCheckpoint(value.lastCheckpoint)) return false
+  if (typeof value.lastAssistantText !== "string") return false
+  if (typeof value.lastAssistantMessageID !== "string") return false
   if (typeof value.autoTurns !== "number") return false
   if (value.lastContinuationAt != null && typeof value.lastContinuationAt !== "number") return false
   if (value.remainingTokens !== null && typeof value.remainingTokens !== "number") return false
@@ -170,7 +243,19 @@ function isGoalSnapshot(value: unknown): value is GoalSnapshot {
 
 function parseGoalToolOutput(part: GoalToolPart): GoalSnapshot | null | undefined {
   if (part.type !== "tool") return undefined
-  if (!["get_goal", "create_goal", "update_goal", "update_goal_status", "clear_goal"].includes(part.tool ?? "")) return undefined
+  if (
+    ![
+      "get_goal",
+      "get_goal_history",
+      "create_goal",
+      "set_goal",
+      "update_goal",
+      "update_goal_objective",
+      "update_goal_status",
+      "clear_goal",
+    ].includes(part.tool ?? "")
+  )
+    return undefined
   if (part.state?.status !== "completed") return undefined
   if (part.tool === "clear_goal") return null
   if (typeof part.state.output !== "string") return undefined
@@ -207,18 +292,20 @@ function goalFromSession(api: TuiPluginApi, sessionID: string) {
   return goalStateFromSession(api, sessionID).goal
 }
 
-function visibleStatus(status: GoalSnapshot["status"]) {
-  return status === "budgetLimited" ? "active" : status
-}
-
 function formatGoal(goal: GoalSnapshot | null) {
   if (!goal) return "No recent goal state found in this session."
   const lines = [
     `Objective: ${goal.objective}`,
-    `Status: ${visibleStatus(goal.status)}`,
+    `Status: ${goal.status}`,
     `Time used: ${formatDuration(goal.timeUsedSeconds)}`,
-    `Auto-continues: ${goal.autoTurns}`,
+    `Tokens: ${goal.tokensUsed}${goal.tokenBudget == null ? "" : `/${goal.tokenBudget}`}`,
+    `Auto-continues: ${goal.autoTurns}${goal.maxAutoTurns == null ? "" : `/${goal.maxAutoTurns}`}`,
   ]
+  if (goal.remainingTokens != null) lines.push(`Tokens remaining: ${goal.remainingTokens}`)
+  if (goal.maxDurationSeconds != null) lines.push(`Duration limit: ${formatDuration(goal.maxDurationSeconds)}`)
+  if (goal.noProgressTurns > 0) lines.push(`No-progress turns: ${goal.noProgressTurns}`)
+  if (goal.lastCheckpoint) lines.push(`Latest checkpoint: ${goal.lastCheckpoint.summary}`)
+  if (goal.stopReason) lines.push(`Stop reason: ${goal.stopReason}`)
   if (goal.lastStatus) lines.push(`Last status: ${goal.lastStatus}`)
   if (goal.completionEvidence) lines.push(`Completion evidence: ${goal.completionEvidence}`)
   if (goal.blocker) lines.push(`Blocker: ${goal.blocker}`)
@@ -251,9 +338,22 @@ function GoalSidebar(props: { api: TuiPluginApi; sessionID: string }) {
               <text fg={theme().text}>
                 <b>Goal</b>
               </text>
-              <text fg={theme().textMuted}>Status: {visibleStatus(value().status)}</text>
+              <text fg={theme().textMuted}>Status: {value().status}</text>
               <text fg={theme().textMuted}>Time: {formatDuration(elapsed())}</text>
-              <text fg={theme().textMuted}>Auto-continues: {value().autoTurns}</text>
+              <text fg={theme().textMuted}>
+                Tokens: {value().tokensUsed}
+                <Show when={value().tokenBudget}>{(budget: () => number) => <>/{budget()}</>}</Show>
+              </text>
+              <text fg={theme().textMuted}>
+                Auto-continues: {value().autoTurns}
+                <Show when={value().maxAutoTurns}>{(budget: () => number) => <>/{budget()}</>}</Show>
+              </text>
+              <Show when={value().lastCheckpoint}>
+                {(checkpoint: () => GoalCheckpoint) => <text fg={theme().textMuted}>Checkpoint: {checkpoint().summary}</text>}
+              </Show>
+              <Show when={value().stopReason}>
+                {(reason: () => string) => <text fg={theme().textMuted}>Stop: {reason()}</text>}
+              </Show>
               <Show when={value().lastStatus}>
                 {(status: () => string) => <text fg={theme().textMuted}>{status()}</text>}
               </Show>
@@ -271,6 +371,27 @@ function GoalSidebar(props: { api: TuiPluginApi; sessionID: string }) {
   )
 }
 
+function registerGoalCommand(api: TuiPluginApi, command: TuiCommand) {
+  const modern = api as ModernTuiApi
+  if (modern.keymap?.registerLayer) {
+    modern.keymap.registerLayer({
+      commands: [
+        {
+          namespace: "palette",
+          name: command.value,
+          title: command.title,
+          desc: command.description,
+          category: command.category,
+          run: command.onSelect,
+        },
+      ],
+      bindings: [],
+    })
+    return
+  }
+  api.command?.register(() => [command])
+}
+
 const tui: TuiPlugin = async (api) => {
   api.slots.register({
     order: 125,
@@ -281,19 +402,17 @@ const tui: TuiPlugin = async (api) => {
     },
   })
 
-  api.command.register(() => [
-    {
-      title: "Goal",
-      value: "goal.show",
-      category: "Goal",
-      description: "View or clear the long-running session goal",
-      onSelect: () => {
-        const sessionID = sessionIDOrToast(api)
-        if (!sessionID) return
-        showSummary(api, sessionID, goalFromSession(api, sessionID))
-      },
+  registerGoalCommand(api, {
+    title: "Goal",
+    value: "goal.show",
+    category: "Goal",
+    description: "View, pause, resume, or clear the long-running session goal",
+    onSelect: () => {
+      const sessionID = sessionIDOrToast(api)
+      if (!sessionID) return
+      showSummary(api, sessionID, goalFromSession(api, sessionID))
     },
-  ])
+  })
 }
 
 const plugin: TuiPluginModule = {