opencube 0.2.1 → 0.3.1

package/README.md

@@ -21,7 +21,7 @@ OpenCube is packaged as an opencode plugin plus an Electron desktop process.
 
 ## Install
 
-Install globally through opencode:
+Install the latest published version globally through opencode:
 
 ```sh
 opencode plugin opencube --global
@@ -41,6 +41,30 @@ You can also add it manually to `~/.config/opencode/opencode.json`:
 }
 ```
 
+## Update
+
+If you already installed OpenCube and want to upgrade, reinstall the target version with `--force`:
+
+```sh
+opencode plugin opencube@0.3.1 --global --force
+```
+
+Using an explicit version is recommended for upgrades because it avoids stale `latest` cache behavior. You can still install the npm latest tag if desired:
+
+```sh
+opencode plugin opencube@latest --global --force
+```
+
+Then fully restart opencode and run `/pet` again. OpenCube and opencode plugins are loaded at startup, so the running desktop pet is not hot-replaced in place.
+
+You can ask OpenCube to check npm for the latest published version:
+
+```text
+/pet_update
+```
+
+`/pet_update` does not hot-replace the running plugin. It reports whether a newer version exists and prints an explicit `opencode plugin opencube@<version> --global --force` command to run.
+
 ## Commands
 
 | Command | Description |
@@ -49,6 +73,8 @@ You can also add it manually to `~/.config/opencode/opencode.json`:
 | `/pet_stop` | Quit OpenCube. |
 | `/pet_say_hello` | Flash one currently free face three times with a random color. |
 | `/pet_fancy_say_hello` | Run a denser randomized light show across currently free faces. |
+| `/pet_update` | Check npm for a newer OpenCube release and show the upgrade command. |
+| `/pet_upgrade` | Alias for `/pet_update`. |
 
 These commands are handled by the plugin and do not get sent to the model.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencube",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "A tiny Three.js desktop pet for opencode session activity.",
   "main": "src/main.js",
   "exports": {

package/src/main.js

@@ -27,6 +27,7 @@ let petSignals = []
 let sessionMap = new Map()
 let activeToolsBySession = new Map()
 let pendingPermissionsByRequest = new Map()
+let pendingQuestionsByRequest = new Map()
 let cleanupTimer = null
 let dragState = null
 
@@ -133,6 +134,7 @@ function recordEvent(event) {
   applySessionEvent(item)
   applyToolEvent(item)
   applyPermissionEvent(item)
+  applyQuestionEvent(item)
   if (item.type === "hello" || item.type === "fancy_hello") {
     petSignals.push({
       id: item.id,
@@ -180,6 +182,33 @@ function clearPendingPermissionsForSession(sessionID) {
   }
 }
 
+function applyQuestionEvent(event) {
+  if (!event || typeof event.sessionID !== "string") return
+
+  if (event.type === "question.ask") {
+    const requestID = typeof event.requestID === "string" ? event.requestID : event.id
+    if (!requestID) return
+    pendingQuestionsByRequest.set(requestID, {
+      requestID,
+      sessionID: event.sessionID,
+      questions: event.questions,
+      tool: event.tool,
+      askedAt: event.receivedAt || Date.now(),
+    })
+    return
+  }
+
+  if (event.type === "question.reply" || event.type === "question.reject") {
+    if (typeof event.requestID === "string") pendingQuestionsByRequest.delete(event.requestID)
+  }
+}
+
+function clearPendingQuestionsForSession(sessionID) {
+  for (const [requestID, question] of pendingQuestionsByRequest) {
+    if (question?.sessionID === sessionID) pendingQuestionsByRequest.delete(requestID)
+  }
+}
+
 function applyToolEvent(event) {
   if (!event || typeof event.sessionID !== "string" || typeof event.callID !== "string") return
   if (event.type !== "tool.start" && event.type !== "tool.finish") return
@@ -237,6 +266,7 @@ function applySessionEvent(event) {
   if (event.type === "session.idle") {
     activeToolsBySession.delete(event.sessionID)
     clearPendingPermissionsForSession(event.sessionID)
+    clearPendingQuestionsForSession(event.sessionID)
     sessionMap.set(event.sessionID, {
       sessionID: event.sessionID,
       state: "idle",
@@ -259,6 +289,7 @@ function pruneIdleSessions(refresh = true) {
       sessionMap.delete(sessionID)
       activeToolsBySession.delete(sessionID)
       clearPendingPermissionsForSession(sessionID)
+      clearPendingQuestionsForSession(sessionID)
       changed = true
     }
   }
@@ -294,6 +325,7 @@ function getPetState() {
       color: DEFAULT_SESSION_COLORS[index % DEFAULT_SESSION_COLORS.length],
     })),
     permissions: Array.from(pendingPermissionsByRequest.values()),
+    questions: Array.from(pendingQuestionsByRequest.values()),
     signals: petSignals,
   }
 }
@@ -759,7 +791,7 @@ function petHtml3D() {
       const dragParticleTexture = createDragParticleTexture()
       const faceGeometry = new THREE.PlaneGeometry(0.60, 0.60)
       const glowGeometry = new THREE.PlaneGeometry(1.18, 1.18)
-      const permissionGlowGeometry = new THREE.PlaneGeometry(1.42, 1.42)
+      const permissionGlowGeometry = new THREE.PlaneGeometry(1.62, 1.62)
       const rad = THREE.MathUtils.degToRad
 
       function createGlowTexture() {
@@ -1279,7 +1311,7 @@ function petHtml3D() {
           permissionGlowGeometry,
           new THREE.MeshBasicMaterial({
             map: glowTexture,
-            color: 0xff2448,
+            color: 0xffffff,
             transparent: true,
             opacity: 0,
             blending: THREE.AdditiveBlending,
@@ -1287,7 +1319,7 @@ function petHtml3D() {
             side: THREE.DoubleSide,
           }),
         )
-        permissionGlow.position.set(...glowPosition.map((value) => value === 0 ? 0 : value * 1.055))
+        permissionGlow.position.set(...glowPosition.map((value) => value === 0 ? 0 : value * 1.072))
         permissionGlow.rotation.set(...rotation)
         cubeGroup.add(permissionGlow)
         permissionGlowMeshes.set(name, permissionGlow)
@@ -1494,13 +1526,15 @@ function petHtml3D() {
           const sessionID = Array.from(pendingSessionIDs).find((id) => sessionFaceMap.get(id) === faceName)
           if (!sessionID) {
             permissionGlow.material.opacity = 0
+            permissionGlow.scale.setScalar(1)
             continue
           }
 
-          permissionGlow.material.color.setRGB(1, 0.08, 0.16)
-          permissionGlow.material.opacity = 0.16 + pulse * 0.62
-          permissionGlow.scale.setScalar(1.00 + pulse * 0.34)
-          active[faceName] = { sessionID, pulse, pending: true }
+          const color = sessionColorMap.get(sessionID) || randomSessionGlowColor()
+          permissionGlow.material.color.setRGB(color.r / 255, color.g / 255, color.b / 255)
+          permissionGlow.material.opacity = 0.14 + pulse * 0.60
+          permissionGlow.scale.setScalar(1.06 + pulse * 0.42)
+          active[faceName] = { sessionID, pulse, pending: true, color: color.name, rgb: [color.r, color.g, color.b] }
         }
 
         return active
@@ -1565,7 +1599,8 @@ function petHtml3D() {
         const toolParticles = updateToolParticles(sessions, dt, now)
         processSignals(snapshot.signals || [], now)
         const helloFlashes = applyFlashFaces(now)
-        const permissionGlows = applyPermissionGlowFaces(snapshot.permissions || [], now)
+        const pendingAttention = [...(snapshot.permissions || []), ...(snapshot.questions || [])]
+        const permissionGlows = applyPermissionGlowFaces(pendingAttention, now)
         renderCube()
         latestDebug = {
           now: Date.now(),

package/src/plugin-server.cjs

@@ -1,7 +1,9 @@
 const { quitPet, sendEvent, showPet } = require("./plugin-shared.cjs")
+const pkg = require("../package.json")
 
 const COMMAND_HANDLED_SENTINEL = "__OPENCODE_PET_COMMAND_HANDLED__"
 const CUB_ICON = "◈"
+const UPDATE_CHECK_TIMEOUT_MS = 5000
 
 function handled() {
   throw new Error(COMMAND_HANDLED_SENTINEL)
@@ -27,6 +29,72 @@ function isFancySayHello(input) {
   return input.command === "pet_fancy_say_hello"
 }
 
+function isUpdateCheck(input) {
+  return input.command === "pet_update" || input.command === "pet_upgrade"
+}
+
+function compareVersions(a, b) {
+  const left = String(a || "").split(".").map((part) => Number.parseInt(part, 10) || 0)
+  const right = String(b || "").split(".").map((part) => Number.parseInt(part, 10) || 0)
+  const length = Math.max(left.length, right.length)
+  for (let index = 0; index < length; index += 1) {
+    const diff = (left[index] || 0) - (right[index] || 0)
+    if (diff !== 0) return diff > 0 ? 1 : -1
+  }
+  return 0
+}
+
+async function fetchLatestPackageVersion(name = pkg.name, timeoutMs = UPDATE_CHECK_TIMEOUT_MS) {
+  const controller = new AbortController()
+  const timeout = setTimeout(() => controller.abort(), timeoutMs)
+
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(name)}/latest`, {
+      headers: { accept: "application/json" },
+      signal: controller.signal,
+    })
+    if (!response.ok) throw new Error(`npm registry returned ${response.status}`)
+    const info = await response.json()
+    return {
+      name: info.name || name,
+      version: info.version,
+      tarball: info.dist?.tarball,
+    }
+  } catch (error) {
+    if (error?.name === "AbortError") throw new Error(`npm registry check timed out after ${timeoutMs}ms`)
+    throw error
+  } finally {
+    clearTimeout(timeout)
+  }
+}
+
+function formatUpdateNotice(latest) {
+  const current = pkg.version
+  if (!latest?.version) return cubNotice(`Could not read the latest ${pkg.name} version from npm.`, "△")
+
+  const comparison = compareVersions(latest.version, current)
+  if (comparison < 0) {
+    return cubNotice(
+      [
+        `Welcome to the tiny time machine ✨`,
+        `This OpenCube is a dev build (${current}), ahead of npm (${latest.version}).`,
+        `Keep this cube away from paradoxes and production users.`,
+      ].join("\n"),
+      "✧",
+    )
+  }
+  if (comparison === 0) return cubNotice(`OpenCube is up to date (${current}).`, "✓")
+
+  return cubNotice(
+    [
+      `OpenCube ${latest.version} is available. Current version: ${current}.`,
+      `Upgrade with: opencode plugin ${pkg.name}@${latest.version} --global --force`,
+      `Then fully restart opencode and run /pet again.`,
+    ].join("\n"),
+    "↻",
+  )
+}
+
 async function injectNotice(client, sessionID, text) {
   if (!sessionID || !client?.session?.prompt) return
 
@@ -85,10 +153,18 @@ module.exports = {
           template: "/pet_fancy_say_hello",
           description: "Trigger a randomized light show on OpenCube's free faces.",
         }
+        cfg.command.pet_update = {
+          template: "/pet_update",
+          description: "Check npm for a newer OpenCube version and show the upgrade command.",
+        }
+        cfg.command.pet_upgrade = {
+          template: "/pet_upgrade",
+          description: "Alias for /pet_update.",
+        }
       },
 
       "command.execute.before": async (input, output) => {
-        if (!["pet", "pet_stop", "pet_say_hello", "pet_fancy_say_hello"].includes(input.command)) return
+        if (!["pet", "pet_stop", "pet_say_hello", "pet_fancy_say_hello", "pet_update", "pet_upgrade"].includes(input.command)) return
 
         // There is no official cancel primitive in command.execute.before yet.
         // Throwing this sentinel aborts the command flow before opencode sends
@@ -129,6 +205,39 @@ module.exports = {
               ? cubNotice("OpenCube is putting on a light show ✨", "✺")
               : cubNotice("OpenCube is sleeping... zzz  Start it with /pet before the light show.", "☾"),
           )
+        } else if (isUpdateCheck(input)) {
+          let latest
+          try {
+            latest = await fetchLatestPackageVersion()
+            const versionComparison = compareVersions(latest.version, pkg.version)
+            await sendEvent({
+              type: "update.check",
+              message: "OpenCube checked npm for updates",
+              package: pkg.name,
+              currentVersion: pkg.version,
+              latestVersion: latest.version,
+              updateAvailable: versionComparison > 0,
+              devVersion: versionComparison < 0,
+              tarball: latest.tarball,
+              timeoutMs: UPDATE_CHECK_TIMEOUT_MS,
+              sessionID: input.sessionID,
+              source: "opencube-plugin",
+            })
+          } catch (error) {
+            await sendEvent({
+              type: "update.check_failed",
+              message: "OpenCube could not check npm for updates",
+              package: pkg.name,
+              currentVersion: pkg.version,
+              error: error?.message || String(error),
+              sessionID: input.sessionID,
+              source: "opencube-plugin",
+            })
+            await injectNotice(client, input.sessionID, cubNotice(`Could not check npm for OpenCube updates: ${error?.message || error}`, "△"))
+            handled()
+          }
+
+          await injectNotice(client, input.sessionID, formatUpdateNotice(latest))
         } else {
           await showPet({
             onProgress: (message) => injectNotice(client, input.sessionID, message),
@@ -169,6 +278,45 @@ module.exports = {
           return
         }
 
+        if (event.type === "question.asked") {
+          const question = event.properties || {}
+          await sendEvent({
+            type: "question.ask",
+            message: "opencode is waiting for a question answer",
+            sessionID: question.sessionID,
+            requestID: question.id,
+            questions: question.questions,
+            tool: question.tool,
+            source: "opencube-plugin",
+          })
+          return
+        }
+
+        if (event.type === "question.replied") {
+          const question = event.properties || {}
+          await sendEvent({
+            type: "question.reply",
+            message: "opencode question was answered",
+            sessionID: question.sessionID,
+            requestID: question.requestID,
+            answers: question.answers,
+            source: "opencube-plugin",
+          })
+          return
+        }
+
+        if (event.type === "question.rejected") {
+          const question = event.properties || {}
+          await sendEvent({
+            type: "question.reject",
+            message: "opencode question was rejected",
+            sessionID: question.sessionID,
+            requestID: question.requestID,
+            source: "opencube-plugin",
+          })
+          return
+        }
+
         if (event.type !== "session.status") return
 
         const sessionID = event.properties?.sessionID