opencode-router 0.11.77

package/.env.example

@@ -0,0 +1,23 @@
+OPENCODE_URL=http://127.0.0.1:4096
+OPENCODE_DIRECTORY=
+OPENCODE_SERVER_USERNAME=
+OPENCODE_SERVER_PASSWORD=
+
+TELEGRAM_BOT_TOKEN=
+TELEGRAM_ENABLED=true
+
+SLACK_BOT_TOKEN=
+SLACK_APP_TOKEN=
+SLACK_ENABLED=true
+
+OPENCODE_ROUTER_DATA_DIR=~/.openwork/opencode-router
+OPENCODE_ROUTER_DB_PATH=~/.openwork/opencode-router/opencode-router.db
+OPENCODE_ROUTER_CONFIG_PATH=~/.openwork/opencode-router/opencode-router.json
+# Alias for OPENCODE_ROUTER_HEALTH_PORT (preferred name)
+OPENCODE_ROUTER_HEALTH_PORT=
+OPENCODE_ROUTER_HEALTH_PORT=3005
+TOOL_UPDATES_ENABLED=false
+GROUPS_ENABLED=false
+TOOL_OUTPUT_LIMIT=1200
+PERMISSION_MODE=allow
+LOG_LEVEL=info

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Different AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# opencode-router
+
+Simple Slack + Telegram bridge + directory router for a running `opencode` server.
+
+## Install + Run
+
+One-command install (recommended):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/different-ai/openwork/dev/packages/opencode-router/install.sh | bash
+```
+
+Or install from npm:
+
+```bash
+npm install -g opencode-router
+```
+
+Quick run without install:
+
+```bash
+npx opencode-router
+```
+
+Then follow the guided setup (choose what to configure, start).
+
+1) One-command setup (installs deps, builds, creates `.env` if missing):
+
+```bash
+pnpm -C packages/opencode-router setup
+```
+
+2) (Optional) Fill in `packages/opencode-router/.env` (see `.env.example`).
+
+Required:
+- `OPENCODE_URL`
+- `OPENCODE_DIRECTORY`
+
+Recommended:
+- `OPENCODE_SERVER_USERNAME`
+- `OPENCODE_SERVER_PASSWORD`
+
+3) Run the router:
+
+```bash
+opencode-router
+```
+
+## Telegram
+
+Telegram support is configured via identities. You can either:
+- Use env vars for a single bot: `TELEGRAM_BOT_TOKEN=...`
+ - Or add multiple bots to the config file (`opencode-router.json`) using the CLI:
+
+```bash
+opencode-router telegram add <token> --id default
+opencode-router telegram list
+```
+
+## Slack (Socket Mode)
+
+Slack support uses Socket Mode and replies in threads when @mentioned in channels.
+
+1) Create a Slack app.
+2) Enable Socket Mode and generate an app token (`xapp-...`).
+3) Add bot token scopes:
+   - `chat:write`
+   - `app_mentions:read`
+   - `im:history`
+4) Subscribe to events (bot events):
+   - `app_mention`
+   - `message.im`
+5) Set env vars (or save via `opencode-router slack add ...`):
+    - `SLACK_BOT_TOKEN=xoxb-...`
+    - `SLACK_APP_TOKEN=xapp-...`
+    - `SLACK_ENABLED=true`
+
+To add multiple Slack apps:
+
+```bash
+opencode-router slack add <xoxb> <xapp> --id default
+opencode-router slack list
+```
+
+## Identity-Scoped Routing
+
+The router routes messages based on `(channel, identityId, peerId) -> directory` bindings.
+
+```bash
+opencode-router bindings set --channel telegram --identity default --peer <chatId> --dir /path/to/workdir
+opencode-router bindings list
+```
+
+## Health Server (Local HTTP)
+
+The router can expose a small local HTTP server for health/config and simple message dispatch.
+
+- `OPENCODE_ROUTER_HEALTH_PORT` controls the port (OpenWork defaults to a random free port when using `openwork`).
+- `PORT` is also accepted as a convenience if the above are unset.
+- `OPENCODE_ROUTER_HEALTH_HOST` controls bind host (default: `127.0.0.1`).
+
+Send a message to all peers bound to a directory:
+
+```bash
+curl -sS "http://127.0.0.1:${OPENCODE_ROUTER_HEALTH_PORT:-3005}/send" \
+  -H 'Content-Type: application/json' \
+  -d '{"channel":"telegram","directory":"/path/to/workdir","text":"hello"}'
+```
+
+## Commands
+
+```bash
+opencode-router start
+opencode-router status
+
+opencode-router telegram list
+opencode-router telegram add <token> --id default
+
+opencode-router slack list
+opencode-router slack add <xoxb> <xapp> --id default
+
+opencode-router bindings list
+opencode-router bindings set --channel telegram --identity default --peer <chatId> --dir /path/to/workdir
+```
+
+## Defaults
+
+- SQLite at `~/.openwork/opencode-router/opencode-router.db` unless overridden.
+- Config stored at `~/.openwork/opencode-router/opencode-router.json` (created by `opencode-router` or `pnpm -C packages/opencode-router setup`).
+- Group chats are disabled unless `GROUPS_ENABLED=true`.
+
+## Tests
+
+```bash
+pnpm -C packages/opencode-router test:unit
+pnpm -C packages/opencode-router test:smoke
+pnpm -C packages/opencode-router test:cli
+pnpm -C packages/opencode-router test:npx
+```

package/install.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OPENCODE_ROUTER_REF="${OPENCODE_ROUTER_REF:-dev}"
+OPENCODE_ROUTER_REPO="${OPENCODE_ROUTER_REPO:-https://github.com/different-ai/openwork.git}"
+OPENCODE_ROUTER_INSTALL_DIR="${OPENCODE_ROUTER_INSTALL_DIR:-$HOME/.openwork/opencode-router/openwork}"
+OPENCODE_ROUTER_BIN_DIR="${OPENCODE_ROUTER_BIN_DIR:-$HOME/.local/bin}"
+OPENCODE_ROUTER_INSTALL_METHOD="${OPENCODE_ROUTER_INSTALL_METHOD:-npm}"
+
+usage() {
+  cat <<'EOF'
+opencode-router installer
+
+Environment variables:
+  OPENCODE_ROUTER_INSTALL_DIR  Install directory (default: ~/.openwork/opencode-router/openwork)
+  OPENCODE_ROUTER_REPO         Git repo (default: https://github.com/different-ai/openwork.git)
+  OPENCODE_ROUTER_REF          Git ref/branch (default: dev)
+  OPENCODE_ROUTER_BIN_DIR      Bin directory for shims (default: ~/.local/bin)
+  OPENCODE_ROUTER_INSTALL_METHOD  Install method: npm|git (default: npm)
+
+Example:
+  OPENCODE_ROUTER_INSTALL_DIR=~/opencode-router curl -fsSL https://raw.githubusercontent.com/different-ai/openwork/dev/packages/opencode-router/install.sh | bash
+EOF
+}
+
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  usage
+  exit 0
+fi
+
+require_bin() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "Missing $1. Please install it and retry." >&2
+    exit 1
+  fi
+}
+
+require_bin node
+
+if [[ "$OPENCODE_ROUTER_INSTALL_METHOD" == "npm" ]]; then
+  echo "Installing opencode-router via npm..."
+  npm install -g opencode-router
+else
+  require_bin git
+  if ! command -v pnpm >/dev/null 2>&1; then
+    if command -v corepack >/dev/null 2>&1; then
+      corepack enable >/dev/null 2>&1 || true
+      corepack prepare pnpm@10.27.0 --activate
+    else
+      echo "pnpm is required. Install pnpm or enable corepack, then retry." >&2
+      exit 1
+    fi
+  fi
+
+  if [[ -d "$OPENCODE_ROUTER_INSTALL_DIR/.git" ]]; then
+    echo "Updating opencode-router source in $OPENCODE_ROUTER_INSTALL_DIR"
+    git -C "$OPENCODE_ROUTER_INSTALL_DIR" fetch origin --prune
+    if git -C "$OPENCODE_ROUTER_INSTALL_DIR" show-ref --verify --quiet "refs/remotes/origin/$OPENCODE_ROUTER_REF"; then
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" checkout -B "$OPENCODE_ROUTER_REF" "origin/$OPENCODE_ROUTER_REF"
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" pull --ff-only origin "$OPENCODE_ROUTER_REF"
+    else
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" checkout -f
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" pull --ff-only
+    fi
+  else
+    echo "Cloning opencode-router source to $OPENCODE_ROUTER_INSTALL_DIR"
+    mkdir -p "$OPENCODE_ROUTER_INSTALL_DIR"
+    git clone --depth 1 "$OPENCODE_ROUTER_REPO" "$OPENCODE_ROUTER_INSTALL_DIR"
+    if git -C "$OPENCODE_ROUTER_INSTALL_DIR" show-ref --verify --quiet "refs/remotes/origin/$OPENCODE_ROUTER_REF"; then
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" checkout -B "$OPENCODE_ROUTER_REF" "origin/$OPENCODE_ROUTER_REF"
+    fi
+  fi
+
+  if [[ ! -d "$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router" ]]; then
+    echo "opencode-router package not found on ref '$OPENCODE_ROUTER_REF'. Trying dev/main..." >&2
+    git -C "$OPENCODE_ROUTER_INSTALL_DIR" fetch origin --prune
+    if git -C "$OPENCODE_ROUTER_INSTALL_DIR" show-ref --verify --quiet refs/remotes/origin/dev; then
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" checkout -B dev origin/dev
+    elif git -C "$OPENCODE_ROUTER_INSTALL_DIR" show-ref --verify --quiet refs/remotes/origin/main; then
+      git -C "$OPENCODE_ROUTER_INSTALL_DIR" checkout -B main origin/main
+    fi
+  fi
+
+  if [[ ! -d "$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router" ]]; then
+    echo "opencode-router package not found after checkout. Aborting." >&2
+    exit 1
+  fi
+
+  echo "Installing dependencies..."
+  pnpm -C "$OPENCODE_ROUTER_INSTALL_DIR" install
+
+  echo "Building opencode-router..."
+  pnpm -C "$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router" build
+
+  ENV_PATH="$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router/.env"
+  ENV_EXAMPLE="$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router/.env.example"
+  if [[ ! -f "$ENV_PATH" ]]; then
+    if [[ -f "$ENV_EXAMPLE" ]]; then
+      cp "$ENV_EXAMPLE" "$ENV_PATH"
+      echo "Created $ENV_PATH"
+    else
+      cat <<EOF > "$ENV_PATH"
+OPENCODE_URL=http://127.0.0.1:4096
+OPENCODE_DIRECTORY=
+TELEGRAM_BOT_TOKEN=
+SLACK_BOT_TOKEN=
+SLACK_APP_TOKEN=
+EOF
+      echo "Created $ENV_PATH (minimal)"
+    fi
+  fi
+
+  mkdir -p "$OPENCODE_ROUTER_BIN_DIR"
+  cat <<EOF > "$OPENCODE_ROUTER_BIN_DIR/opencode-router"
+#!/usr/bin/env bash
+set -euo pipefail
+node "$OPENCODE_ROUTER_INSTALL_DIR/packages/opencode-router/dist/cli.js" "$@"
+EOF
+  chmod 755 "$OPENCODE_ROUTER_BIN_DIR/opencode-router"
+fi
+
+if ! echo ":$PATH:" | grep -q ":$OPENCODE_ROUTER_BIN_DIR:"; then
+  shell_name="$(basename "${SHELL:-}" 2>/dev/null || true)"
+  case "$shell_name" in
+    fish)
+      echo "Add to PATH (fish): set -Ux PATH $OPENCODE_ROUTER_BIN_DIR \$PATH"
+      ;;
+    zsh)
+      echo "Add to PATH (zsh):  echo 'export PATH=\"$OPENCODE_ROUTER_BIN_DIR:\$PATH\"' >> ~/.zshrc"
+      ;;
+    bash)
+      echo "Add to PATH (bash): echo 'export PATH=\"$OPENCODE_ROUTER_BIN_DIR:\$PATH\"' >> ~/.bashrc"
+      ;;
+    *)
+      echo "Add to PATH: export PATH=\"$OPENCODE_ROUTER_BIN_DIR:\$PATH\""
+      ;;
+  esac
+fi
+
+cat <<EOF
+
+opencode-router installed.
+
+Next steps:
+1) Edit: $ENV_PATH
+2) Run: opencode-router start
+EOF

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "opencode-router",
+  "version": "0.11.77",
+  "description": "opencode-router: Slack + Telegram bridge + directory routing for a running opencode server",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "opencode-router": "dist/cli.js"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/different-ai/openwork.git",
+    "directory": "packages/opencode-router"
+  },
+  "keywords": [
+    "opencode",
+    "router",
+    "slack",
+    "telegram",
+    "bridge",
+    "bot"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example",
+    "install.sh"
+  ],
+  "dependencies": {
+    "@opencode-ai/sdk": "^1.1.31",
+    "@slack/socket-mode": "^2.0.5",
+    "@slack/web-api": "^7.13.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.7",
+    "grammy": "^1.39.3",
+    "pino": "^9.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "bun-types": "^1.3.6",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "dev": "bun src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "build:bin": "bun ./script/build.ts --outdir dist/bin --filename opencode-router",
+    "build:bin:all": "bun ./script/build.ts --outdir dist/bin --filename opencode-router --target bun-darwin-arm64 --target bun-darwin-x64 --target bun-linux-x64 --target bun-linux-arm64 --target bun-windows-x64",
+    "build:binary": "bun ./script/build.ts --outdir dist/bin --filename opencode-router",
+    "start": "bun dist/cli.js start",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "setup": "bun scripts/setup.mjs",
+    "test:unit": "pnpm build && bun test test/*.test.js",
+    "test:smoke": "bun scripts/smoke.mjs",
+    "test:cli": "pnpm build && bun scripts/test-cli.mjs",
+    "test:npx": "bun scripts/test-npx.mjs"
+  }
+}