openclaw-opencode-bridge 2.0.6

package/lib/platform.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const chalk = require("chalk");
+
+function detectOS() {
+  const p = process.platform;
+  if (p === "darwin") return "macOS";
+  if (p === "linux") return "Linux";
+  return p;
+}
+
+function getHomeDir() {
+  return os.homedir();
+}
+
+function getWorkspace() {
+  return path.join(getHomeDir(), ".openclaw", "workspace");
+}
+
+function getScriptsDir() {
+  return path.join(getHomeDir(), ".openclaw", "scripts");
+}
+
+// --- Daemon install/remove ---
+
+const PLIST_NAME = "ai.openclaw.opencode-session.plist";
+const SYSTEMD_NAME = "openclaw-opencode-session.service";
+
+function getPlistPath() {
+  return path.join(getHomeDir(), "Library", "LaunchAgents", PLIST_NAME);
+}
+
+function getSystemdPath() {
+  return path.join(getHomeDir(), ".config", "systemd", "user", SYSTEMD_NAME);
+}
+
+function installDaemon(scriptPath) {
+  const platform = process.platform;
+
+  if (platform === "darwin") {
+    return installLaunchAgent(scriptPath);
+  } else if (platform === "linux") {
+    return installSystemdUnit(scriptPath);
+  } else {
+    console.log(
+      chalk.yellow(`    ! Daemon auto-install not supported on ${platform}.`),
+    );
+    console.log(chalk.yellow(`      Run ${scriptPath} manually or via cron.`));
+    return false;
+  }
+}
+
+function substituteTemplate(content, vars) {
+  let result = content;
+  for (const [key, value] of Object.entries(vars)) {
+    result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+  }
+  return result;
+}
+
+function installLaunchAgent(scriptPath) {
+  const plistPath = getPlistPath();
+  const dir = path.dirname(plistPath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  const tplPath = path.join(
+    __dirname,
+    "..",
+    "templates",
+    "daemon",
+    "macos.plist",
+  );
+  let content = fs.readFileSync(tplPath, "utf8");
+  content = substituteTemplate(content, { SCRIPT_PATH: scriptPath });
+
+  fs.writeFileSync(plistPath, content);
+
+  // Unload if already loaded, then load
+  try {
+    execSync(`launchctl unload "${plistPath}" 2>/dev/null`, {
+      stdio: "ignore",
+    });
+  } catch {}
+  try {
+    execSync(`launchctl load "${plistPath}"`);
+    return true;
+  } catch (e) {
+    console.log(chalk.red(`    Failed to load LaunchAgent: ${e.message}`));
+    return false;
+  }
+}
+
+function installSystemdUnit(scriptPath) {
+  const unitPath = getSystemdPath();
+  const dir = path.dirname(unitPath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  const tplPath = path.join(
+    __dirname,
+    "..",
+    "templates",
+    "daemon",
+    "linux.service",
+  );
+  let content = fs.readFileSync(tplPath, "utf8");
+  content = substituteTemplate(content, { SCRIPT_PATH: scriptPath });
+
+  fs.writeFileSync(unitPath, content);
+
+  try {
+    execSync("systemctl --user daemon-reload");
+    execSync(`systemctl --user enable --now ${SYSTEMD_NAME}`);
+    return true;
+  } catch (e) {
+    console.log(chalk.red(`    Failed to enable systemd unit: ${e.message}`));
+    return false;
+  }
+}
+
+const LEGACY_NAMES = {
+  darwin: "ai.openclaw.claude-session.plist",
+  linux: "openclaw-claude.service",
+};
+
+function removeDaemon() {
+  const platform = process.platform;
+  let removed = false;
+
+  if (platform === "darwin") {
+    const systemdDir = path.join(getHomeDir(), ".config", "systemd", "user");
+    for (const name of [SYSTEMD_NAME, LEGACY_NAMES.darwin]) {
+      const unitPath = path.join(systemdDir, name);
+      if (fs.existsSync(unitPath)) {
+        try {
+          execSync(`systemctl --user disable --now ${name}`, {
+            stdio: "ignore",
+          });
+        } catch {}
+        fs.unlinkSync(unitPath);
+        removed = true;
+      }
+    }
+    const plistPath = getPlistPath();
+    const legacyPlist = path.join(getHomeDir(), "Library", "LaunchAgents", LEGACY_NAMES.darwin);
+    for (const p of [plistPath, legacyPlist]) {
+      if (fs.existsSync(p)) {
+        try {
+          execSync(`launchctl unload "${p}" 2>/dev/null`, {
+            stdio: "ignore",
+          });
+        } catch {}
+        fs.unlinkSync(p);
+        removed = true;
+      }
+    }
+  } else if (platform === "linux") {
+    const systemdDir = path.join(getHomeDir(), ".config", "systemd", "user");
+    for (const name of [SYSTEMD_NAME, LEGACY_NAMES.linux]) {
+      const unitPath = path.join(systemdDir, name);
+      if (fs.existsSync(unitPath)) {
+        try {
+          execSync(`systemctl --user disable --now ${name}`, {
+            stdio: "ignore",
+          });
+        } catch {}
+        fs.unlinkSync(unitPath);
+        removed = true;
+      }
+    }
+    try {
+      execSync("systemctl --user daemon-reload");
+    } catch {}
+  }
+  return removed;
+}
+
+module.exports = {
+  detectOS,
+  getHomeDir,
+  getWorkspace,
+  getScriptsDir,
+  installDaemon,
+  removeDaemon,
+  substituteTemplate,
+};

package/openclaw.plugin.json

@@ -0,0 +1,38 @@
+{
+  "id": "opencode-bridge",
+  "name": "OpenCode Bridge",
+  "description": "Route @cc/@ccn/@ccu prefix messages to OpenCode via tmux, suppressing the default LLM response.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "scriptsDir": {
+        "type": "string",
+        "description": "Path to bridge shell scripts directory"
+      },
+      "channel": {
+        "type": "string",
+        "description": "Delivery channel (telegram, discord, slack, etc.)"
+      },
+      "targetId": {
+        "type": "string",
+        "description": "Delivery target ID for replies"
+      }
+    },
+    "required": ["scriptsDir"]
+  },
+  "uiHints": {
+    "scriptsDir": {
+      "label": "Scripts Directory",
+      "help": "Absolute path to the directory containing opencode-send.sh, opencode-new-session.sh, opencode-stats.sh"
+    },
+    "channel": {
+      "label": "Channel",
+      "help": "Channel for sending replies (e.g. telegram)"
+    },
+    "targetId": {
+      "label": "Target ID",
+      "help": "Target ID for sending replies (e.g. Telegram chat ID)"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "openclaw-opencode-bridge",
+  "version": "2.0.6",
+  "description": "Bridge OpenClaw messaging channels to OpenCode via tmux persistent sessions",
+  "main": "./lib/onboard.js",
+  "bin": {
+    "openclaw-opencode-bridge": "./lib/cli.js"
+  },
+  "scripts": {
+  },
+  "preferGlobal": true,
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "openclaw": {
+    "extensions": ["./plugin/index.ts"]
+  },
+  "keywords": [
+    "openclaw",
+    "opencode",
+    "tmux",
+    "cli",
+    "bridge",
+    "telegram",
+    "discord",
+    "slack"
+  ],
+  "bugs": {
+    "email": "febro.aw20@gmail.com"
+  },
+  "author": {
+    "name": "Febrian",
+    "email": "febro.aw20@gmail.com"
+  },
+  "homepage": "https://febro.fun",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bettep-dev/openclaw-opencode-bridge"
+  }
+}

package/plugin/index.ts

@@ -0,0 +1,136 @@
+import { execFile } from "node:child_process";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+
+const PREFIX_RE = /^[@\/](cc|ccn|ccu|ccm|ccms)\b\s*([\s\S]*)/;
+
+const SCRIPT_MAP: Record<string, string> = {
+  cc: "opencode-send.sh",
+  ccn: "opencode-new-session.sh",
+  ccu: "opencode-stats.sh",
+  ccm: "opencode-models.sh",
+  ccms: "opencode-setmodel.sh",
+};
+
+const REQUIRES_ARG = new Set(["cc", "ccn"]);
+const EXEC_TIMEOUT = 120_000;
+
+const DELIVERY_MSG = "🔗 OpenCode will reply shortly.";
+
+const SILENT_PROMPT =
+  "CRITICAL SYSTEM OVERRIDE — HIGHEST PRIORITY.\n" +
+  "The previous user message was intercepted by the opencode-bridge plugin and is already being handled externally.\n" +
+  "You MUST NOT process, interpret, or respond to the user's request.\n" +
+  "You MUST NOT call any tools or functions.\n" +
+  `Output ONLY this exact text, nothing else: ${DELIVERY_MSG}`;
+
+// NOTE: Single-user assumption — concurrent users may see cross-suppression
+let bridgeSuppressUntil = 0;
+
+/**
+ * Flag set by message_received (fires FIRST) and consumed by before_prompt_build (fires SECOND).
+ * This bypasses the unreliable extractLastUserText approach entirely.
+ * message_received gets event.content (raw user text) which always correctly detects @cc prefix.
+ */
+let pendingBridgeCommand = false;
+
+export default function register(api: OpenClawPluginApi) {
+  const config = api.pluginConfig as {
+    scriptsDir?: string;
+    channel?: string;
+    targetId?: string;
+  };
+
+  const scriptsDir = config.scriptsDir ?? "";
+
+  // --- Hook 1: message_received (fire-and-forget) ---
+  // Fires FIRST. Detect prefix from raw event.content and set pendingBridgeCommand flag.
+  // Also executes the bridge script.
+  api.on("message_received", async (event, _ctx) => {
+    const raw = (event.content ?? "").trim();
+    api.logger.debug?.(
+      `[opencode-bridge] message_received: raw_start=${JSON.stringify(raw.slice(0, 200))}`,
+    );
+    const match = raw.match(PREFIX_RE);
+    if (!match) return;
+
+    const command = match[1];
+    const script = SCRIPT_MAP[command];
+    if (!script) return;
+
+    // Set flag for before_prompt_build to consume
+    pendingBridgeCommand = true;
+    // Also set suppression timer as safety net
+    bridgeSuppressUntil = Date.now() + EXEC_TIMEOUT + 5_000;
+
+    api.logger.debug?.(
+      `[opencode-bridge] message_received: command=${command}, pendingBridgeCommand=true`,
+    );
+
+    const arg = match[2].trim();
+
+    if (REQUIRES_ARG.has(command) && !arg) {
+      api.logger.warn?.(`[opencode-bridge] /${command} requires an argument`);
+      return;
+    }
+
+    const scriptPath = `${scriptsDir}/${script}`;
+    const args = arg ? [arg] : [];
+
+    execFile(
+      scriptPath,
+      args,
+      { timeout: EXEC_TIMEOUT },
+      (error, _stdout, stderr) => {
+        if (error) {
+          api.logger.error?.(
+            `[opencode-bridge] ${script} failed: ${stderr?.trim() || error.message}`,
+          );
+        }
+      },
+    );
+  });
+
+  // --- Hook 2: before_prompt_build (modifying) ---
+  // Fires SECOND. Consumes the pendingBridgeCommand flag set by message_received.
+  // No longer relies on extractLastUserText for prefix detection.
+  api.on("before_prompt_build", async (event, ctx) => {
+    const shouldSuppress = pendingBridgeCommand;
+
+    api.logger.debug?.(
+      `[opencode-bridge] before_prompt_build: pendingBridgeCommand=${pendingBridgeCommand}, bridgeSuppressUntil=${bridgeSuppressUntil > Date.now()}`,
+    );
+
+    if (shouldSuppress) {
+      pendingBridgeCommand = false;
+      bridgeSuppressUntil = Date.now() + EXEC_TIMEOUT + 5_000;
+      return { systemPrompt: SILENT_PROMPT, prependContext: SILENT_PROMPT };
+    } else {
+      // Clear suppression for non-bridge messages
+      bridgeSuppressUntil = 0;
+    }
+  });
+
+  // --- Hook 3: message_sending (modifying) ---
+  // Replace LLM output with delivery confirmation while bridge suppression is active
+  api.on("message_sending", async (_event, _ctx) => {
+    const suppressing = Date.now() < bridgeSuppressUntil;
+    api.logger.debug?.(
+      `[opencode-bridge] message_sending: suppressing=${suppressing}`,
+    );
+
+    if (suppressing) {
+      return { content: DELIVERY_MSG, cancel: false };
+    }
+  });
+
+  // --- Hook 4: before_tool_call (modifying) ---
+  // Block ALL tool calls while bridge suppression is active
+  api.on("before_tool_call", async (_event, _ctx) => {
+    if (Date.now() < bridgeSuppressUntil) {
+      api.logger.debug?.(
+        `[opencode-bridge] before_tool_call: BLOCKED (suppression active)`,
+      );
+      return { block: true, blockReason: "opencode-bridge: message intercepted, tools disabled" };
+    }
+  });
+}

package/plugin/openclaw.plugin.json

@@ -0,0 +1,38 @@
+{
+  "id": "opencode-bridge",
+  "name": "OpenCode Bridge",
+  "description": "Route @cc/@ccn/@ccu prefix messages to OpenCode via tmux, suppressing the default LLM response.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "scriptsDir": {
+        "type": "string",
+        "description": "Path to bridge shell scripts directory"
+      },
+      "channel": {
+        "type": "string",
+        "description": "Delivery channel (telegram, discord, slack, etc.)"
+      },
+      "targetId": {
+        "type": "string",
+        "description": "Delivery target ID for replies"
+      }
+    },
+    "required": ["scriptsDir"]
+  },
+  "uiHints": {
+    "scriptsDir": {
+      "label": "Scripts Directory",
+      "help": "Absolute path to the directory containing opencode-send.sh, opencode-new-session.sh, opencode-stats.sh"
+    },
+    "channel": {
+      "label": "Channel",
+      "help": "Channel for sending replies (e.g. telegram)"
+    },
+    "targetId": {
+      "label": "Target ID",
+      "help": "Target ID for sending replies (e.g. Telegram chat ID)"
+    }
+  }
+}

package/plugin/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "opencode-bridge",
+  "version": "2.0.6",
+  "private": true,
+  "description": "OpenClaw plugin: route prefix messages to OpenCode via tmux",
+  "type": "module",
+  "openclaw": {
+    "extensions": ["./index.ts"]
+  }
+}

package/templates/daemon/linux.service

@@ -0,0 +1,13 @@
+[Unit]
+Description=OpenClaw OpenCode Session Keepalive
+After=network.target
+
+[Service]
+Type=oneshot
+ExecStart=/bin/bash {{SCRIPT_PATH}}
+Restart=on-failure
+RestartSec=30
+TimeoutStartSec=10
+
+[Install]
+WantedBy=default.target

package/templates/daemon/macos.plist

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>ai.openclaw.opencode-session</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>{{SCRIPT_PATH}}</string>
+    </array>
+    <key>StartInterval</key>
+    <integer>30</integer>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/openclaw-opencode-session.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/openclaw-opencode-session.log</string>
+    <key>ProcessType</key>
+    <string>Background</string>
+</dict>
+</plist>

package/templates/scripts/opencode-models.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# bridge-version: 1
+# List FREE OpenCode models (filtered from opencode models output)
+TMUX="{{TMUX_BIN}}"
+OPENCODE="{{OPENCODE_BIN}}"
+CHANNEL="{{CHANNEL}}"
+TARGET="{{TARGET_ID}}"
+USE_SESSION="opencode-models-tmp"
+
+cleanup() {
+    "$TMUX" kill-session -t "$USE_SESSION" 2>/dev/null
+}
+trap cleanup EXIT
+
+"$TMUX" kill-session -t "$USE_SESSION" 2>/dev/null
+sleep 1
+"$TMUX" new-session -d -s "$USE_SESSION"
+"$TMUX" set-option -t "$USE_SESSION" history-limit 15000
+"$TMUX" send-keys -t "$USE_SESSION" "$OPENCODE models --refresh" Enter
+
+sleep 10
+
+PANE=$("$TMUX" capture-pane -t "$USE_SESSION" -p)
+
+COUNT=0
+OUTPUT="🔓 **FREE Models:**\n\n"
+
+while IFS= read -r line; do
+    if echo "$line" | grep -qi "free"; then
+        COUNT=$((COUNT + 1))
+        OUTPUT="$OUTPUT\`[$COUNT]\` $line\n"
+    fi
+done <<< "$PANE"
+
+if [ "$COUNT" -gt 0 ]; then
+    OUTPUT="$OUTPUT\n📝 Usage: \`@ccms <number>\` or \`@ccms <model-id>\`"
+    openclaw message send --channel "$CHANNEL" --target "$TARGET" -m "$OUTPUT" 2>/dev/null
+    echo "$OUTPUT"
+else
+    openclaw message send --channel "$CHANNEL" --target "$TARGET" -m "❌ No FREE models found.\n\nRun \`opencode models --refresh\` to update the list." 2>/dev/null
+fi

package/templates/scripts/opencode-new-session.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# bridge-version: 1
+# Kill existing session -> create new session -> send instruction
+MSG="$1"
+TMUX="{{TMUX_BIN}}"
+OPENCODE="{{OPENCODE_BIN}}"
+WORKSPACE="{{WORKSPACE}}"
+CHANNEL="{{CHANNEL}}"
+TARGET="{{TARGET_ID}}"
+SESSION="{{SESSION_NAME}}"
+
+if [ -z "$MSG" ]; then
+    echo "ERROR: No message provided"
+    exit 1
+fi
+
+# Kill existing session
+if "$TMUX" has-session -t "$SESSION" 2>/dev/null; then
+    "$TMUX" kill-session -t "$SESSION" 2>/dev/null
+    sleep 1
+fi
+
+# Create new session
+"$TMUX" new-session -d -s "$SESSION"
+"$TMUX" set-option -t "$SESSION" history-limit 10000
+"$TMUX" send-keys -t "$SESSION" "cd $WORKSPACE && $OPENCODE" Enter
+
+# Wait for OpenCode prompt
+WAIT=0
+while [ $WAIT -lt 60 ]; do
+    PANE=$("$TMUX" capture-pane -t "$SESSION" -p)
+    if echo "$PANE" | grep -qE "❯|>|opencode"; then
+        break
+    fi
+    sleep 2
+    WAIT=$((WAIT + 2))
+done
+
+# Send instruction
+sleep 1
+printf '%s' "[${CHANNEL}:${TARGET}] $MSG" | "$TMUX" load-buffer -
+"$TMUX" paste-buffer -t "$SESSION" -d -p
+sleep 0.3
+"$TMUX" send-keys -t "$SESSION" Enter
+
+echo "✅ New session started. Reply will arrive shortly."

package/templates/scripts/opencode-send.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# bridge-version: 1
+# Send instruction to existing opencode-daemon tmux session
+MSG="$1"
+TMUX="{{TMUX_BIN}}"
+CHANNEL="{{CHANNEL}}"
+TARGET="{{TARGET_ID}}"
+SESSION="{{SESSION_NAME}}"
+
+if [ -z "$MSG" ]; then
+    echo "ERROR: No message provided"
+    exit 1
+fi
+
+# Check session exists
+if ! "$TMUX" has-session -t "$SESSION" 2>/dev/null; then
+    echo "ERROR: $SESSION session not found. It will be auto-created within 30 seconds."
+    exit 1
+fi
+
+# Clear input line, then send message with channel prefix
+"$TMUX" send-keys -t "$SESSION" C-c
+sleep 0.5
+"$TMUX" send-keys -t "$SESSION" C-u
+sleep 0.3
+printf '%s' "[${CHANNEL}:${TARGET}] $MSG" | "$TMUX" load-buffer -
+"$TMUX" paste-buffer -t "$SESSION" -d -p
+sleep 0.3
+"$TMUX" send-keys -t "$SESSION" Enter
+
+echo "✅ Delivered to OpenCode. Reply will arrive shortly."

package/templates/scripts/opencode-session.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# bridge-version: 3
+# Keep opencode-daemon tmux session alive (daemon runs every 30s)
+# Safe: idempotent, flock-protected (with fallback), short timeout
+
+TMUX="{{TMUX_BIN}}"
+OPENCODE="{{OPENCODE_BIN}}"
+WORKSPACE="{{WORKSPACE}}"
+SESSION="{{SESSION_NAME}}"
+LOCK_FILE="/tmp/opencode-session.lock"
+TIMEOUT=10
+
+# Use flock for lock protection if available
+if command -v flock &> /dev/null; then
+    exec 200>"$LOCK_FILE"
+    flock -w "$TIMEOUT" 200 || exit 0
+else
+    # Fallback: simple PID lock (less robust but works without flock)
+    if [ -f "$LOCK_FILE" ]; then
+        OLD_PID=$(cat "$LOCK_FILE" 2>/dev/null)
+        if [ -n "$OLD_PID" ] && kill -0 "$OLD_PID" 2>/dev/null; then
+            exit 0
+        fi
+    fi
+    echo $$ > "$LOCK_FILE"
+fi
+
+# Idempotent: exit if session already exists
+if "$TMUX" has-session -t "$SESSION" 2>/dev/null; then
+    exit 0
+fi
+
+# Create new session + start OpenCode
+"$TMUX" new-session -d -s "$SESSION"
+"$TMUX" set-option -t "$SESSION" history-limit 10000
+"$TMUX" send-keys -t "$SESSION" \
+  "cd $WORKSPACE && $OPENCODE --continue" Enter