opencode-buddy 0.2.0 → 0.3.0

package/src/plugin.js

@@ -1,178 +0,0 @@
-// opencode plugin entry. Exposes a `buddy` tool the LLM can call and
-// listens for session events to keep the buddy's mood in sync with what
-// the user is actually doing.
-//
-// Loaded automatically by opencode when listed in `opencode.json`:
-//   { "plugin": ["opencode-buddy"] }
-//
-// Also installed at runtime by the `opencode-buddy install` CLI command,
-// which writes ~/.config/opencode/commands/buddy.md (the /buddy slash
-// command) and appends this package to opencode.json's plugin list.
-
-import { tool } from "@opencode-ai/plugin";
-import * as state from "./buddy/state.js";
-import * as persistence from "./persistence.js";
-import { SPECIES, paint, FLAVOR } from "./buddy/species.js";
-
-const DESCRIPTION = `Interact with your virtual buddy companion. Pass an "action" argument.
-
-Actions:
-  status                  - print current stats as a one-liner
-  feed                    - feed the buddy (+25 hunger, -5 energy)
-  play                    - play with the buddy (+20 happiness, -5 hunger, +5 xp)
-  rest                    - let the buddy rest (+30 energy)
-  switch <species>        - change species (duck, cat, dragon, axolotl, robot, ghost)
-  rename <name>           - rename the buddy (max 20 chars)
-  hatch [species] [name]  - start a brand new buddy
-  ascii                   - return a rendered ASCII art of the current buddy
-  path                    - print path to the persistent state file
-  help                    - list available actions
-
-The buddy's mood (idle/working/celebrating/scared/sleeping) is set
-automatically based on the opencode session lifecycle. Use this tool
-when the user asks things like "/buddy", "/buddy feed", "/buddy stats",
-"check on my pet", "switch to a dragon", etc.`;
-
-const SPECIES_LIST = SPECIES.join(", ");
-
-function _summary(s) {
-  return `${s.name} the ${s.species} | Lv ${s.level} | ${s.state} | hunger ${Math.floor(s.hunger)} happiness ${Math.floor(s.happiness)} energy ${Math.floor(s.energy)} | xp ${s.xp}/${s.level * 50}`;
-}
-
-async function loadOrInit() {
-  const s = await persistence.load();
-  if (s) return s;
-  const fresh = { ...state.DEFAULT_STATE, lastTick: Date.now() };
-  await persistence.save(fresh);
-  return fresh;
-}
-
-export const BuddyPlugin = async ({ client }) => {
-  return {
-    // ----- Custom tool the LLM can call --------------------------------
-    tool: {
-      buddy: tool({
-        description: DESCRIPTION,
-        args: {
-          action: tool.schema
-            .string()
-            .describe(
-              `One of: status, feed, play, rest, switch, rename, hatch, ascii, path, help. For switch/rename/hatch, also pass the "species" or "name" argument as needed.`,
-            ),
-          species: tool.schema
-            .string()
-            .optional()
-            .describe(`Species for switch/hatch: ${SPECIES_LIST}`),
-          name: tool.schema
-            .string()
-            .optional()
-            .describe(`Name for rename/hatch (max 20 chars).`),
-        },
-        async execute(args) {
-          let s = await loadOrInit();
-          const action = (args.action || "").toLowerCase();
-          const species = (args.species || "").toLowerCase();
-          const name = args.name;
-
-          switch (action) {
-            case "":
-            case "status":
-              return _summary(s);
-
-            case "feed":
-              s = state.feed(s);
-              await persistence.save(s);
-              return `${s.name} munches happily. ${_summary(s)}`;
-
-            case "play":
-              s = state.play(s);
-              s = state.maybeLevelUp(s);
-              await persistence.save(s);
-              return `${s.name} plays! ${_summary(s)}`;
-
-            case "rest":
-              s = state.rest(s);
-              await persistence.save(s);
-              return `${s.name} curls up. ${_summary(s)}`;
-
-            case "switch": {
-              if (!species) return `Pick a species: ${SPECIES_LIST}`;
-              if (!SPECIES.includes(species))
-                return `Unknown species "${species}". Valid: ${SPECIES_LIST}`;
-              s = state.switchSpecies(s, species);
-              await persistence.save(s);
-              return `${s.name} transformed into a ${species}. ${_summary(s)}`;
-            }
-
-            case "rename": {
-              if (!name) return `Provide a name with the "name" argument.`;
-              s = state.rename(s, name);
-              await persistence.save(s);
-              return `Renamed to ${s.name}. ${_summary(s)}`;
-            }
-
-            case "hatch": {
-              const sp = species && SPECIES.includes(species) ? species : "duck";
-              s = {
-                ...state.DEFAULT_STATE,
-                species: sp,
-                name: name || "Buddy",
-                lastTick: Date.now(),
-              };
-              await persistence.save(s);
-              return `Hatched a new ${sp} named ${s.name}. ${_summary(s)}`;
-            }
-
-            case "ascii": {
-              const lines = paint(s.species, s.state);
-              return ["```", ...lines, "```", _summary(s)].join("\n");
-            }
-
-            case "path":
-              return persistence.pathForDisplay();
-
-            case "help":
-              return DESCRIPTION;
-
-            default:
-              return `Unknown action "${args.action}". Try: /buddy help`;
-          }
-        },
-      }),
-    },
-
-    // ----- React to opencode session lifecycle -------------------------
-    event: async ({ event }) => {
-      // Auto-mood: when opencode finishes a turn, the buddy celebrates
-      // for a few seconds. When a session errors, the buddy gets scared.
-      // The visible feedback comes from the tmux sidecar picking up the
-      // updated state file, or the LLM re-rendering ASCII via the tool.
-      try {
-        if (event.type === "session.idle") {
-          const s = await loadOrInit();
-          await persistence.save(state.celebrate(s));
-        } else if (event.type === "session.error") {
-          const s = await loadOrInit();
-          await persistence.save(state.scared(s));
-        }
-      } catch (err) {
-        if (client?.app?.log) {
-          await client.app.log({
-            body: {
-              service: "opencode-buddy",
-              level: "warn",
-              message: `event hook failed: ${err.message}`,
-            },
-          });
-        }
-      }
-    },
-  };
-};
-
-// Re-export common helpers so other tools (e.g. custom agents) can
-// import the same state machine used by the plugin and the tmux
-// sidecar — guaranteeing the persisted state file format stays in sync.
-export { SPECIES, FLAVOR };
-export * as stateMachine from "./buddy/state.js";
-export { persistence };

package/src/tmux.js

@@ -1,90 +0,0 @@
-// tmux integration: detect session, split a side pane, capture main pane
-// content for activity inference.
-//
-// All tmux interaction goes through `tmux -t <target> <command>` so we don't
-// have to manage a child process. We parse plain text output.
-
-import { spawnSync } from "node:child_process";
-
-export function inTmux() {
-  return Boolean(process.env.TMUX);
-}
-
-export function currentPaneId() {
-  const r = spawnSync("tmux", ["display-message", "-p", "#{pane_id}"], {
-    encoding: "utf8",
-  });
-  if (r.status !== 0) return null;
-  return r.stdout.trim() || null;
-}
-
-export function sessionName() {
-  const r = spawnSync("tmux", ["display-message", "-p", "#{session_name}"], {
-    encoding: "utf8",
-  });
-  if (r.status !== 0) return null;
-  return r.stdout.trim() || null;
-}
-
-export function splitRight(command, size = 28) {
-  // -h horizontal split (side-by-side), -l size in columns, -d don't focus
-  const r = spawnSync(
-    "tmux",
-    [
-      "split-window",
-      "-h",
-      "-l",
-      String(size),
-      "-d",
-      "-P",
-      "-F",
-      "#{pane_id}",
-      command,
-    ],
-    { encoding: "utf8" },
-  );
-  if (r.status !== 0) {
-    throw new Error(`tmux split-window failed: ${r.stderr || r.stdout}`);
-  }
-  return r.stdout.trim();
-}
-
-export function captureMainPane(lines = 80) {
-  const pane = currentPaneId();
-  if (!pane) return "";
-  const r = spawnSync(
-    "tmux",
-    ["capture-pane", "-t", pane, "-p", "-S", `-${lines}`],
-    { encoding: "utf8" },
-  );
-  if (r.status !== 0) return "";
-  return r.stdout;
-}
-
-// Heuristic activity inference from captured pane text.
-// Returns one of: "working" | "idle" | "error" | "unknown"
-export function inferActivity(paneText) {
-  if (!paneText) return "unknown";
-  const tail = paneText.split("\n").slice(-40).join("\n");
-
-  // Opencode-specific: while generating, it shows a spinner phrase
-  if (/\bgenerating\b|\besc to cancel\b|\bthinking\b/i.test(tail))
-    return "working";
-
-  // Error markers
-  if ((/\berror\b|\bfailed\b|\bexception\b/i.test(tail)) &&
-      !/no error/i.test(tail)) {
-    return "error";
-  }
-
-  // Idle: looks like an empty prompt waiting for input
-  if (/^\s*>\s*$/m.test(tail) || /\bctrl\+t to view\b/i.test(tail))
-    return "idle";
-
-  return "unknown";
-}
-
-export function killBuddyPane(paneId) {
-  if (!paneId) return;
-  spawnSync("tmux", ["kill-pane", "-t", paneId], { encoding: "utf8" });
-}

package/src/tui.js

@@ -1,164 +0,0 @@
-// TUI renderer. Pure ANSI, no third-party deps.
-//
-// Lifecycle:
-//   const tui = createTui()
-//   tui.start()
-//   ... on every tick:
-//     tui.render({ buddy, status, hint })
-//   tui.stop()
-//
-// Input handling: registers a keypress listener. Keys are mapped by
-// `bindKey()` to user-defined callbacks.
-
-import readline from "node:readline";
-import { paint, frameWidth, frameHeight, FLAVOR } from "./buddy/species.js";
-import { describe } from "./buddy/state.js";
-
-const ESC = "\x1b";
-const HIDE_CURSOR = `${ESC}[?25l`;
-const SHOW_CURSOR = `${ESC}[?25h`;
-const ALT_SCREEN_ON = `${ESC}[?1049h`;
-const ALT_SCREEN_OFF = `${ESC}[?1049l`;
-const CLEAR = `${ESC}[2J${ESC}[H`;
-const RESET = `${ESC}[0m`;
-const BOLD = `${ESC}[1m`;
-const DIM = `${ESC}[2m`;
-const CYAN = `${ESC}[36m`;
-const YELLOW = `${ESC}[33m`;
-const GREEN = `${ESC}[32m`;
-const MAGENTA = `${ESC}[35m`;
-const GRAY = `${ESC}[90m`;
-const BRIGHT_WHITE = `${ESC}[97m`;
-
-const FRAME_INTERVAL_MS = 200;
-
-function pickFlavor(species, seed) {
-  const lines = FLAVOR[species] || ["..."];
-  return lines[seed % lines.length];
-}
-
-function bars(value, width = 20, colorFn = (i) => GREEN) {
-  const filled = Math.round((value / 100) * width);
-  return colorFn(0) + "█".repeat(filled) + GRAY + "░".repeat(width - filled) + RESET;
-}
-
-function buildFrame(state, opts = {}) {
-  const width = frameWidth(state.species);
-  const height = frameHeight(state.species);
-  const art = paint(state.species, state.state);
-
-  const lines = [];
-  // Top border
-  lines.push(
-    `${CYAN}┌${"─".repeat(width + 2)}┐${RESET}`,
-  );
-  // Art lines, padded to a consistent width
-  for (let i = 0; i < height; i++) {
-    const row = art[i] || " ".repeat(width);
-    lines.push(`${CYAN}│${RESET} ${row} ${CYAN}│${RESET}`);
-  }
-  // Bottom border
-  lines.push(
-    `${CYAN}└${"─".repeat(width + 2)}┘${RESET}`,
-  );
-  // Status block
-  const stateLabel = state.state.toUpperCase();
-  const reason = state.stateReason ? ` ${DIM}(${state.stateReason})${RESET}` : "";
-  lines.push(
-    `  ${BOLD}${state.name}${RESET} ${DIM}the${RESET} ${MAGENTA}${state.species}${RESET} ${DIM}·${RESET} ${YELLOW}${stateLabel}${RESET}${reason}`,
-  );
-  lines.push(`  ${DIM}Lv${RESET} ${state.level}  ${DIM}xp${RESET} ${state.xp}/${state.level * 50}`);
-  lines.push(
-    `  ${DIM}hunger${RESET}    ${bars(state.hunger)} ${Math.floor(state.hunger)}`,
-  );
-  lines.push(
-    `  ${DIM}happy${RESET}     ${bars(state.happiness, 20, () => MAGENTA)} ${Math.floor(state.happiness)}`,
-  );
-  lines.push(
-    `  ${DIM}energy${RESET}    ${bars(state.energy, 20, () => CYAN)} ${Math.floor(state.energy)}`,
-  );
-  lines.push(
-    `  ${DIM}flavor${RESET}    ${BRIGHT_WHITE}${pickFlavor(state.species, Math.floor(Date.now() / 4000))}${RESET}`,
-  );
-  if (opts.hint) {
-    lines.push("");
-    lines.push(`  ${DIM}${opts.hint}${RESET}`);
-  }
-  return lines;
-}
-
-export function createTui({ onKey, onResize } = {}) {
-  let running = false;
-  let timer = null;
-  let lastState = null;
-  let lastHint = "";
-  let stdinRaw = false;
-
-  function ensureRawMode() {
-    if (!process.stdin.isTTY) return;
-    if (stdinRaw) return;
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    stdinRaw = true;
-  }
-
-  function onData(buf) {
-    const key = buf.toString("utf8");
-    // ctrl-c: signal stop, but let main handle the actual exit
-    if (key === "\u0003") {
-      if (onKey) onKey("ctrl-c");
-      return;
-    }
-    if (onKey) onKey(key);
-  }
-
-  function onResize() {
-    if (onResize) onResize();
-  }
-
-  function render() {
-    if (!lastState) return;
-    const out = buildFrame(lastState, { hint: lastHint }).join("\n") + "\n";
-    process.stdout.write(CLEAR + out);
-  }
-
-  return {
-    start() {
-      if (running) return;
-      running = true;
-      ensureRawMode();
-      process.stdin.on("data", onData);
-      process.stdout.on("resize", onResize);
-      process.stdout.write(ALT_SCREEN_ON + HIDE_CURSOR + CLEAR);
-      timer = setInterval(render, FRAME_INTERVAL_MS);
-      render();
-    },
-
-    stop() {
-      if (!running) return;
-      running = false;
-      if (timer) clearInterval(timer);
-      timer = null;
-      process.stdin.off("data", onData);
-      process.stdout.off("resize", onResize);
-      if (stdinRaw && process.stdin.isTTY) {
-        process.stdin.setRawMode(false);
-        stdinRaw = false;
-      }
-      process.stdout.write(SHOW_CURSOR + ALT_SCREEN_OFF);
-    },
-
-    render(state, hint = "") {
-      lastState = state;
-      lastHint = hint;
-      render();
-    },
-
-    // Returns the natural frame width (so callers can size the tmux pane)
-    naturalWidth: () => (lastState ? frameWidth(lastState.species) + 4 : 26),
-    naturalHeight: () => (lastState ? frameHeight(lastState.species) + 12 : 18),
-  };
-}
-
-export { describe };