tinker-agent 1.0.0

package/bin/install-agent.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+set -e
+
+# Install dependencies
+apt-get update && apt-get install -y \
+    git curl tmux sudo unzip wget
+
+# Install Node.js (required for Claude CLI)
+if ! command -v node &> /dev/null; then
+  curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
+  apt-get install -y nodejs
+fi
+
+# Install Claude CLI
+npm install -g @anthropic-ai/claude-code
+
+# Install GitHub CLI
+curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list
+apt-get update && apt-get install gh -y
+
+# Setup User
+# We want to run as the same UID as the host user (passed via build arg)
+# to ensure we can edit mounted files.
+USER_ID=${USER_ID:-1000}
+GROUP_ID=${GROUP_ID:-1000}
+AGENT_USER="claude"
+
+# 1. Handle Group
+if getent group ${GROUP_ID} >/dev/null 2>&1; then
+  # Group exists (e.g. 'node'), use it
+  GROUP_NAME=$(getent group ${GROUP_ID} | cut -d: -f1)
+else
+  # Create group
+  groupadd -g ${GROUP_ID} ${AGENT_USER}
+  GROUP_NAME=${AGENT_USER}
+fi
+
+# 2. Handle User
+if getent passwd ${USER_ID} >/dev/null 2>&1; then
+  # User exists (e.g. 'node'), use it
+  AGENT_USER=$(getent passwd ${USER_ID} | cut -d: -f1)
+  # Ensure user is in the group (if different)
+  usermod -aG ${GROUP_NAME} ${AGENT_USER}
+else
+  # Create user
+  useradd -u ${USER_ID} -g ${GROUP_NAME} -m -s /bin/bash ${AGENT_USER}
+fi
+
+# 3. Grant Sudo
+echo "${AGENT_USER} ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
+
+# 4. Determine Home Directory
+AGENT_HOME=$(getent passwd ${AGENT_USER} | cut -d: -f6)
+
+# Create entrypoint
+cat << EOF > /entrypoint.sh
+#!/bin/bash
+set -e
+
+# Copy config files if they exist in /tmp (mounted volumes)
+if [ -f "/tmp/cfg/claude.json" ]; then
+  cp /tmp/cfg/claude.json ${AGENT_HOME}/.claude.json || echo "⚠️ Failed to copy claude.json"
+fi
+if [ -d "/tmp/cfg/claude_dir" ]; then
+  rm -rf ${AGENT_HOME}/.claude
+  cp -r /tmp/cfg/claude_dir ${AGENT_HOME}/.claude || echo "⚠️ Failed to copy claude_dir"
+fi
+if [ -f "/tmp/github-app-privkey.pem" ]; then
+  cp /tmp/github-app-privkey.pem ${AGENT_HOME}/.github-app-privkey.pem || echo "⚠️ Failed to copy github key"
+  chmod 600 ${AGENT_HOME}/.github-app-privkey.pem 2>/dev/null || true
+fi
+
+# Fix permissions
+sudo chown -R ${AGENT_USER}:${GROUP_NAME} ${AGENT_HOME} || echo "⚠️ Failed to chown home"
+
+# Fix permissions of the current directory (project root)
+# This ensures the agent can write CLAUDE.md and .mcp.json
+sudo chown ${AGENT_USER}:${GROUP_NAME} $(pwd) || echo "⚠️ Failed to chown project root"
+
+# Set GitHub App Key Path if not set
+if [ -z "\$GITHUB_APP_PRIVATE_KEY_PATH" ]; then
+  export GITHUB_APP_PRIVATE_KEY_PATH="${AGENT_HOME}/.github-app-privkey.pem"
+else
+  # If it was set to /home/claude/... but we are /home/node, fix it
+  if [[ "\$GITHUB_APP_PRIVATE_KEY_PATH" == *"/home/claude/"* ]] && [ "${AGENT_HOME}" != "/home/claude" ]; then
+    export GITHUB_APP_PRIVATE_KEY_PATH="${AGENT_HOME}/.github-app-privkey.pem"
+  fi
+fi
+
+# Execute command as agent user
+exec sudo -E -u ${AGENT_USER} env "HOME=${AGENT_HOME}" "\$@"
+EOF
+
+chmod +x /entrypoint.sh

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "tinker-agent",
+  "version": "1.0.0",
+  "description": "Tinker Agent Runner",
+  "bin": {
+    "tinker-agent": "./run-tinker-agent.rb"
+  },
+  "files": [
+    "run-tinker-agent.rb",
+    "agents.rb",
+    "setup-agent.rb",
+    "bin/agent-bridge-tmux",
+    "bin/install-agent.sh"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC"
+}

package/run-tinker-agent.rb

@@ -0,0 +1,255 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Tinker Agent Runner
+# Usage: npx tinker-agent [worker|planner|reviewer|orchestrator|researcher]
+#        npx tinker-agent attach [agent-type]
+#
+# Requirements:
+#   - Docker
+#   - Ruby
+#   - Dockerfile.sandbox in project root
+#   - tinker.env.json in project root (gitignored)
+
+require "json"
+
+# Load agent configs
+require_relative "agents"
+
+IMAGE_NAME = "tinker-sandbox"
+
+AGENT_TYPES = AGENT_CONFIGS.keys.freeze
+
+def load_config
+  config_file = File.join(Dir.pwd, "tinker.env.json")
+
+  unless File.exist?(config_file)
+    puts "❌ Error: tinker.env.json not found in current directory"
+    puts ""
+    puts "Create it:"
+    puts "  curl -fsSL https://raw.githubusercontent.com/RoM4iK/tinker-public/main/tinker.env.example.json -o tinker.env.json"
+    puts "  # Edit with your project config"
+    puts "  echo 'tinker.env.json' >> .gitignore"
+    exit 1
+  end
+
+  JSON.parse(File.read(config_file))
+end
+
+def check_dockerfile!
+  unless File.exist?("Dockerfile.sandbox")
+    puts "❌ Error: Dockerfile.sandbox not found"
+    puts ""
+    puts "Please create Dockerfile.sandbox by copying your existing Dockerfile"
+    puts "and adding the required agent dependencies."
+    puts ""
+    puts "See https://github.com/RoM4iK/tinker-public/blob/main/README.md for instructions."
+    exit 1
+  end
+end
+
+def build_docker_image
+  check_dockerfile!
+
+  user_id = `id -u`.strip
+  group_id = `id -g`.strip
+
+  puts "🏗️  Building Docker image..."
+
+  success = system(
+    "docker", "build",
+    "--build-arg", "USER_ID=#{user_id}",
+    "--build-arg", "GROUP_ID=#{group_id}",
+    "-t", IMAGE_NAME,
+    "-f", "Dockerfile.sandbox",
+    "."
+  )
+
+  unless success
+    puts "❌ Failed to build Docker image"
+    exit 1
+  end
+
+  puts "✅ Docker image built"
+end
+
+def run_agent(agent_type, config)
+  unless AGENT_TYPES.include?(agent_type)
+    puts "❌ Unknown agent type: #{agent_type}"
+    puts "   Available: #{AGENT_TYPES.join(', ')}"
+    exit 1
+  end
+
+  agent_def = AGENT_CONFIGS[agent_type]
+  agent_config = config.dig("agents", agent_type) || {}
+  container_name = agent_config["container_name"] || agent_def[:name]
+
+  puts "🚀 Starting #{agent_type} agent..."
+
+  # Stop existing container if running
+  system("docker", "rm", "-f", container_name, err: File::NULL, out: File::NULL)
+
+  # Write banner to a persistent temp file (not auto-deleted)
+  banner_path = "/tmp/tinker-agent-banner-#{agent_type}.txt"
+  File.write(banner_path, agent_def[:banner])
+
+  docker_cmd = [
+    "docker", "run", "-d",
+    "--name", container_name,
+    "--network=host",
+    # Mount Claude config
+    "-v", "#{ENV['HOME']}/.claude.json:/tmp/cfg/claude.json:ro",
+    "-v", "#{ENV['HOME']}/.claude:/tmp/cfg/claude_dir:ro",
+    # Mount agent banner for CLAUDE.md
+    "-v", "#{banner_path}:/tmp/agent-banner.txt:ro",
+    # Skills are downloaded inside container (see entrypoint)
+    "-e", "TINKER_VERSION=main",
+    # Pass config as env vars
+    "-e", "AGENT_TYPE=#{agent_type}",
+    "-e", "PROJECT_ID=#{config['project_id']}",
+    "-e", "RAILS_WS_URL=#{config['rails_ws_url']}",
+    "-e", "RAILS_API_URL=#{config['rails_api_url']}",
+    "-e", "RAILS_API_KEY=#{agent_config['mcp_api_key']}"
+  ]
+
+  # Add Anthropic config
+  if (anthropic = config["anthropic"])
+    docker_cmd += ["-e", "ANTHROPIC_BASE_URL=#{anthropic['base_url']}"] if anthropic["base_url"]
+    docker_cmd += ["-e", "ANTHROPIC_MODEL=#{anthropic['model']}"] if anthropic["model"]
+  end
+
+  # Add GitHub auth
+  github = config["github"] || {}
+  if github["method"] == "app"
+    docker_cmd += [
+      "-e", "GITHUB_APP_CLIENT_ID=#{github['app_client_id']}",
+      "-e", "GITHUB_APP_INSTALLATION_ID=#{github['app_installation_id']}",
+      # Path is set dynamically in entrypoint.sh based on user home
+      "-v", "#{github['app_private_key_path']}:/tmp/github-app-privkey.pem:ro"
+    ]
+    puts "🔐 Using GitHub App authentication"
+  elsif github["token"]
+    docker_cmd += ["-e", "GH_TOKEN=#{github['token']}"]
+    puts "🔑 Using GitHub token authentication"
+  else
+    puts "⚠️  Warning: No GitHub authentication configured"
+  end
+
+  # Add git config
+  if (git_config = config["git"])
+    docker_cmd += ["-e", "GIT_USER_NAME=#{git_config['user_name']}"] if git_config["user_name"]
+    docker_cmd += ["-e", "GIT_USER_EMAIL=#{git_config['user_email']}"] if git_config["user_email"]
+  end
+
+  # Check for local setup-agent.rb (for development)
+  local_setup_script = File.join(File.dirname(__FILE__), "setup-agent.rb")
+  
+  # Check for local agent-bridge binaries (for development)
+  local_bridge = File.join(Dir.pwd, "bin", "agent-bridge")
+  local_tmux = File.join(File.dirname(__FILE__), "bin", "agent-bridge-tmux")
+  
+  mounts = []
+  if File.exist?(local_setup_script)
+    puts "🔧 Using local setup-agent.rb for development"
+    mounts += ["-v", "#{File.expand_path(local_setup_script)}:/tmp/setup-agent.rb:ro"]
+  end
+
+  if File.exist?(local_bridge)
+    puts "🔧 Using local agent-bridge binary"
+    mounts += ["-v", "#{local_bridge}:/tmp/agent-bridge:ro"]
+  end
+  
+  if File.exist?(local_tmux)
+    mounts += ["-v", "#{File.expand_path(local_tmux)}:/tmp/agent-bridge-tmux:ro"]
+  end
+
+  docker_cmd += mounts
+
+  if File.exist?(local_setup_script)
+    docker_cmd += [IMAGE_NAME, "ruby", "/tmp/setup-agent.rb"]
+  else
+    docker_cmd += [IMAGE_NAME]
+  end
+
+  success = system(*docker_cmd)
+
+  if success
+    puts "✅ Agent started in background"
+    puts ""
+    puts "   Attach: npx tinker-agent attach #{agent_type}"
+    puts "   Logs:   docker logs -f #{container_name}"
+    puts "   Stop:   docker stop #{container_name}"
+  else
+    puts "❌ Failed to start agent"
+    exit 1
+  end
+end
+
+def attach_to_agent(agent_type, config)
+  unless AGENT_TYPES.include?(agent_type)
+    puts "❌ Unknown agent type: #{agent_type}"
+    exit 1
+  end
+
+  agent_config = config.dig("agents", agent_type) || {}
+  container_name = agent_config["container_name"] || "tinker-#{agent_type}"
+
+  running = `docker ps --filter name=^#{container_name}$ --format '{{.Names}}'`.strip
+
+  if running.empty?
+    puts "❌ #{agent_type} agent is not running"
+    puts "   Start with: npx tinker-agent #{agent_type}"
+    exit 1
+  end
+
+  puts "📎 Attaching to #{agent_type} agent..."
+  
+  # Determine the user to attach as
+  # We assume the agent is running as the user with the same UID as the host user
+  # (since that's how we build the image)
+  uid = Process.uid
+  user = `docker exec #{container_name} getent passwd #{uid} | cut -d: -f1`.strip
+  
+  if user.empty?
+    # Fallback to 'claude' if detection fails (e.g. different UID mapping)
+    puts "⚠️  Could not detect agent user for UID #{uid}, defaulting to 'claude'"
+    user = "claude"
+  end
+
+  puts "   User: #{user} (UID: #{uid})"
+
+  # Attach to agent session which has the status bar
+  # Must run as agent user since tmux server runs under that user
+  exec("docker", "exec", "-it", "-u", user, container_name, "tmux", "attach", "-t", "agent")
+end
+
+def show_usage
+  puts "Tinker Agent Runner"
+  puts ""
+  puts "Usage: npx tinker-agent [worker|planner|reviewer|orchestrator|researcher]"
+  puts "       npx tinker-agent attach [agent-type]"
+  puts ""
+  puts "Setup:"
+  puts "  1. Create Dockerfile.sandbox (see https://github.com/RoM4iK/tinker-public/blob/main/README.md)"
+  puts "  2. curl -fsSL https://raw.githubusercontent.com/RoM4iK/tinker-public/main/tinker.env.example.json -o tinker.env.json"
+  puts "  3. Edit tinker.env.json with your config"
+  puts "  4. echo 'tinker.env.json' >> .gitignore"
+  puts "  5. npx tinker-agent worker"
+  exit 1
+end
+
+# Main
+show_usage if ARGV.empty?
+
+command = ARGV[0].downcase
+
+if command == "attach"
+  agent_type = ARGV[1]&.downcase
+  abort "Usage: npx tinker-agent attach [agent-type]" unless agent_type
+  config = load_config
+  attach_to_agent(agent_type, config)
+else
+  config = load_config
+  build_docker_image
+  run_agent(command, config)
+end