@better-openclaw/core 1.0.16 → 1.0.18

package/dist/generators/scripts.cjs

@@ -0,0 +1,353 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/generators/scripts.ts
+/**
+* Generates helper shell scripts for managing the OpenClaw Docker Compose stack.
+*
+* Returns a map of file paths (relative to project root) to file contents.
+*/
+function generateScripts() {
+	const files = {};
+	files["scripts/start.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── OpenClaw Start Script ──────────────────────────────────────────────────
+# Production-quality bootstrap: validates prerequisites, auto-generates secrets,
+# creates required directories, and starts all services via Docker Compose.
+# Modelled after the official docker-setup.sh patterns.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_DIR"
+
+echo "🐾 OpenClaw — Starting services..."
+echo ""
+
+# ── Colour helpers (no-op when not a TTY) ────────────────────────────────────
+if [ -t 1 ]; then
+  RED='\\033[0;31m'; GREEN='\\033[0;32m'; YELLOW='\\033[1;33m'; CYAN='\\033[0;36m'; NC='\\033[0m'
+else
+  RED=''; GREEN=''; YELLOW=''; CYAN=''; NC=''
+fi
+
+info()  { echo -e "\${CYAN}ℹ  $*\${NC}"; }
+ok()    { echo -e "\${GREEN}✅ $*\${NC}"; }
+warn()  { echo -e "\${YELLOW}⚠️  $*\${NC}"; }
+err()   { echo -e "\${RED}❌ $*\${NC}" >&2; }
+
+# ── Prerequisite checks ─────────────────────────────────────────────────────
+
+if ! command -v docker &> /dev/null; then
+  err "Docker is not installed. Please install Docker first."
+  echo "   https://docs.docker.com/get-docker/"
+  exit 1
+fi
+
+if ! docker compose version &> /dev/null; then
+  err "Docker Compose (v2) is not available."
+  echo "   https://docs.docker.com/compose/install/"
+  exit 1
+fi
+
+if ! docker info &> /dev/null 2>&1; then
+  err "Docker daemon is not running. Please start Docker."
+  exit 1
+fi
+
+# ── Source .env if it exists ─────────────────────────────────────────────────
+
+if [ -f ".env" ]; then
+  info "Loading existing .env file..."
+  set -a
+  # shellcheck disable=SC1091
+  source .env
+  set +a
+else
+  warn ".env file not found — will create one from .env.example if available."
+  if [ -f ".env.example" ]; then
+    cp .env.example .env
+    info "Created .env from .env.example"
+    set -a
+    # shellcheck disable=SC1091
+    source .env
+    set +a
+  fi
+fi
+
+# ── Auto-generate OPENCLAW_GATEWAY_TOKEN if missing ──────────────────────────
+
+if [ -z "\${OPENCLAW_GATEWAY_TOKEN:-}" ]; then
+  info "Generating OPENCLAW_GATEWAY_TOKEN..."
+  if command -v openssl &> /dev/null; then
+    OPENCLAW_GATEWAY_TOKEN="$(openssl rand -hex 32)"
+  elif command -v python3 &> /dev/null; then
+    OPENCLAW_GATEWAY_TOKEN="$(python3 -c 'import secrets; print(secrets.token_hex(32))')"
+  elif command -v python &> /dev/null; then
+    OPENCLAW_GATEWAY_TOKEN="$(python -c 'import secrets; print(secrets.token_hex(32))')"
+  else
+    err "Cannot generate token: neither openssl nor python3 found."
+    exit 1
+  fi
+  export OPENCLAW_GATEWAY_TOKEN
+
+  # Persist into .env
+  if [ -f ".env" ]; then
+    if grep -q "^OPENCLAW_GATEWAY_TOKEN=" .env 2>/dev/null; then
+      sed -i.bak "s|^OPENCLAW_GATEWAY_TOKEN=.*|OPENCLAW_GATEWAY_TOKEN=\${OPENCLAW_GATEWAY_TOKEN}|" .env && rm -f .env.bak
+    else
+      echo "OPENCLAW_GATEWAY_TOKEN=\${OPENCLAW_GATEWAY_TOKEN}" >> .env
+    fi
+  fi
+  ok "Gateway token generated and saved."
+fi
+
+# ── Apply defaults for optional variables ────────────────────────────────────
+
+export OPENCLAW_VERSION="\${OPENCLAW_VERSION:-latest}"
+export OPENCLAW_GATEWAY_PORT="\${OPENCLAW_GATEWAY_PORT:-18789}"
+export OPENCLAW_BRIDGE_PORT="\${OPENCLAW_BRIDGE_PORT:-18790}"
+export OPENCLAW_GATEWAY_BIND="\${OPENCLAW_GATEWAY_BIND:-lan}"
+export OPENCLAW_CONFIG_DIR="\${OPENCLAW_CONFIG_DIR:-./openclaw/config}"
+export OPENCLAW_WORKSPACE_DIR="\${OPENCLAW_WORKSPACE_DIR:-./openclaw/workspace}"
+
+# ── Create required host directories ────────────────────────────────────────
+
+info "Ensuring host directories exist..."
+mkdir -p "\${OPENCLAW_CONFIG_DIR}"
+mkdir -p "\${OPENCLAW_WORKSPACE_DIR}"
+ok "Directories ready: \${OPENCLAW_CONFIG_DIR}, \${OPENCLAW_WORKSPACE_DIR}"
+
+# ── Check for empty secret values ────────────────────────────────────────────
+
+EMPTY_SECRETS=0
+while IFS='=' read -r key value; do
+  [[ "$key" =~ ^#.*$ ]] && continue
+  [[ -z "$key" ]] && continue
+  if [[ "$key" =~ (PASSWORD|TOKEN|SECRET|SESSION_KEY|COOKIE) ]] && [[ -z "\${value:-}" ]]; then
+    warn "Warning: $key is empty in .env"
+    EMPTY_SECRETS=$((EMPTY_SECRETS + 1))
+  fi
+done < .env 2>/dev/null || true
+
+if [ "$EMPTY_SECRETS" -gt 0 ]; then
+  echo ""
+  warn "$EMPTY_SECRETS secret(s) are empty. Some services may not function until they are set."
+  echo ""
+fi
+
+# ── Pull and start ───────────────────────────────────────────────────────────
+
+echo ""
+info "Pulling latest images..."
+docker compose pull --quiet 2>/dev/null || docker compose pull
+
+echo ""
+info "Starting services..."
+docker compose up -d --remove-orphans
+
+# ── Health-check loop ────────────────────────────────────────────────────────
+
+echo ""
+info "Waiting for services to become healthy..."
+sleep 5
+
+RETRIES=0
+MAX_RETRIES=30
+while [ $RETRIES -lt $MAX_RETRIES ]; do
+  UNHEALTHY=$(docker compose ps --format json 2>/dev/null | grep -c '"unhealthy"' || true)
+  STARTING=$(docker compose ps --format json 2>/dev/null | grep -c '"starting"' || true)
+
+  if [ "$UNHEALTHY" -eq 0 ] && [ "$STARTING" -eq 0 ]; then
+    break
+  fi
+
+  RETRIES=$((RETRIES + 1))
+  sleep 2
+done
+
+echo ""
+docker compose ps
+echo ""
+
+if [ $RETRIES -ge $MAX_RETRIES ]; then
+  warn "Some services may still be starting. Check: docker compose ps"
+else
+  ok "All services are running!"
+fi
+
+# ── Print service URLs & token ───────────────────────────────────────────────
+
+GATEWAY_HOST="localhost"
+if [ "\${OPENCLAW_GATEWAY_BIND}" = "lan" ]; then
+  GATEWAY_HOST="0.0.0.0"
+fi
+
+echo ""
+echo "═══════════════════════════════════════════════════════════════════════════════"
+echo " 🐾 OpenClaw is ready!"
+echo "═══════════════════════════════════════════════════════════════════════════════"
+echo ""
+echo "  Gateway URL:        http://\${GATEWAY_HOST}:\${OPENCLAW_GATEWAY_PORT}"
+echo "  Bridge (WebSocket): ws://\${GATEWAY_HOST}:\${OPENCLAW_BRIDGE_PORT}"
+echo "  Config directory:   \${OPENCLAW_CONFIG_DIR}"
+echo "  Workspace directory:\${OPENCLAW_WORKSPACE_DIR}"
+echo ""
+echo "  Gateway Token:      \${OPENCLAW_GATEWAY_TOKEN}"
+echo ""
+echo "  Manage:"
+echo "    Stop:   ./scripts/stop.sh"
+echo "    Status: ./scripts/status.sh"
+echo "    Update: ./scripts/update.sh"
+echo "    Logs:   docker compose logs -f"
+echo ""
+echo "═══════════════════════════════════════════════════════════════════════════════"
+`;
+	files["scripts/stop.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── OpenClaw Stop Script ───────────────────────────────────────────────────
+# Gracefully stops all services.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_DIR"
+
+echo "🐾 OpenClaw — Stopping services..."
+echo ""
+
+# Graceful shutdown with timeout
+docker compose down --timeout 30
+
+echo ""
+echo "✅ All services stopped."
+`;
+	files["scripts/update.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── OpenClaw Update Script ─────────────────────────────────────────────────
+# Pulls latest images and restarts services.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_DIR"
+
+echo "🐾 OpenClaw — Updating services..."
+echo ""
+
+# Pull latest images
+echo "📦 Pulling latest images..."
+docker compose pull
+
+echo ""
+echo "🔄 Restarting services with new images..."
+docker compose up -d --remove-orphans
+
+echo ""
+echo "⏳ Waiting for services to stabilize..."
+sleep 10
+
+docker compose ps
+
+echo ""
+echo "✅ Update complete!"
+`;
+	files["scripts/backup.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── OpenClaw Backup Script ─────────────────────────────────────────────────
+# Backs up all named Docker volumes to a timestamped directory.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_DIR"
+
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="$PROJECT_DIR/backups/$TIMESTAMP"
+mkdir -p "$BACKUP_DIR"
+
+echo "🐾 OpenClaw — Backing up volumes..."
+echo "   Backup directory: $BACKUP_DIR"
+echo ""
+
+# Get project name from docker compose
+PROJECT_NAME=$(docker compose config --format json 2>/dev/null | grep -o '"name":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "openclaw")
+
+# List all volumes for this project
+VOLUMES=$(docker volume ls --filter "name=\${PROJECT_NAME}" --format "{{.Name}}" 2>/dev/null || true)
+
+if [ -z "$VOLUMES" ]; then
+  echo "⚠️  No volumes found for project: $PROJECT_NAME"
+  echo "   Trying to list all openclaw volumes..."
+  VOLUMES=$(docker volume ls --filter "name=openclaw" --format "{{.Name}}" 2>/dev/null || true)
+fi
+
+if [ -z "$VOLUMES" ]; then
+  echo "❌ No volumes found to back up."
+  exit 1
+fi
+
+BACKED_UP=0
+for VOLUME in $VOLUMES; do
+  echo "📦 Backing up: $VOLUME"
+  docker run --rm \\
+    -v "\${VOLUME}:/source:ro" \\
+    -v "$BACKUP_DIR:/backup" \\
+    alpine tar czf "/backup/\${VOLUME}.tar.gz" -C /source .
+
+  SIZE=$(du -sh "$BACKUP_DIR/\${VOLUME}.tar.gz" | cut -f1)
+  echo "   ✓ $VOLUME ($SIZE)"
+  BACKED_UP=$((BACKED_UP + 1))
+done
+
+TOTAL_SIZE=$(du -sh "$BACKUP_DIR" | cut -f1)
+echo ""
+echo "✅ Backed up $BACKED_UP volume(s) ($TOTAL_SIZE total)"
+echo "   Location: $BACKUP_DIR"
+`;
+	files["scripts/status.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── OpenClaw Status Script ─────────────────────────────────────────────────
+# Shows the current status of all services.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_DIR"
+
+echo "🐾 OpenClaw — Service Status"
+echo ""
+
+# Show compose status
+docker compose ps
+
+echo ""
+echo "── Resource Usage ──────────────────────────────────────────────────────"
+echo ""
+
+# Show resource usage
+docker compose top 2>/dev/null || true
+
+echo ""
+echo "── Disk Usage ─────────────────────────────────────────────────────────"
+echo ""
+
+# Show volume sizes
+docker system df -v 2>/dev/null | head -30 || docker system df 2>/dev/null || true
+
+echo ""
+echo "── Network ────────────────────────────────────────────────────────────"
+echo ""
+
+docker network ls --filter "name=openclaw" --format "table {{.Name}}\\t{{.Driver}}\\t{{.Scope}}" 2>/dev/null || true
+`;
+	return files;
+}
+
+//#endregion
+exports.generateScripts = generateScripts;
+//# sourceMappingURL=scripts.cjs.map

package/dist/generators/scripts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.cjs","names":[],"sources":["../../src/generators/scripts.ts"],"sourcesContent":["/**\n * Generates helper shell scripts for managing the OpenClaw Docker Compose stack.\n *\n * Returns a map of file paths (relative to project root) to file contents.\n */\nexport function generateScripts(): Record<string, string> {\n\tconst files: Record<string, string> = {};\n\n\t// ── scripts/start.sh ────────────────────────────────────────────────────\n\n\tfiles[\"scripts/start.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── OpenClaw Start Script ──────────────────────────────────────────────────\n# Production-quality bootstrap: validates prerequisites, auto-generates secrets,\n# creates required directories, and starts all services via Docker Compose.\n# Modelled after the official docker-setup.sh patterns.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\ncd \"$PROJECT_DIR\"\n\necho \"🐾 OpenClaw — Starting services...\"\necho \"\"\n\n# ── Colour helpers (no-op when not a TTY) ────────────────────────────────────\nif [ -t 1 ]; then\n  RED='\\\\033[0;31m'; GREEN='\\\\033[0;32m'; YELLOW='\\\\033[1;33m'; CYAN='\\\\033[0;36m'; NC='\\\\033[0m'\nelse\n  RED=''; GREEN=''; YELLOW=''; CYAN=''; NC=''\nfi\n\ninfo()  { echo -e \"\\${CYAN}ℹ  $*\\${NC}\"; }\nok()    { echo -e \"\\${GREEN}✅ $*\\${NC}\"; }\nwarn()  { echo -e \"\\${YELLOW}⚠️  $*\\${NC}\"; }\nerr()   { echo -e \"\\${RED}❌ $*\\${NC}\" >&2; }\n\n# ── Prerequisite checks ─────────────────────────────────────────────────────\n\nif ! command -v docker &> /dev/null; then\n  err \"Docker is not installed. Please install Docker first.\"\n  echo \"   https://docs.docker.com/get-docker/\"\n  exit 1\nfi\n\nif ! docker compose version &> /dev/null; then\n  err \"Docker Compose (v2) is not available.\"\n  echo \"   https://docs.docker.com/compose/install/\"\n  exit 1\nfi\n\nif ! docker info &> /dev/null 2>&1; then\n  err \"Docker daemon is not running. Please start Docker.\"\n  exit 1\nfi\n\n# ── Source .env if it exists ─────────────────────────────────────────────────\n\nif [ -f \".env\" ]; then\n  info \"Loading existing .env file...\"\n  set -a\n  # shellcheck disable=SC1091\n  source .env\n  set +a\nelse\n  warn \".env file not found — will create one from .env.example if available.\"\n  if [ -f \".env.example\" ]; then\n    cp .env.example .env\n    info \"Created .env from .env.example\"\n    set -a\n    # shellcheck disable=SC1091\n    source .env\n    set +a\n  fi\nfi\n\n# ── Auto-generate OPENCLAW_GATEWAY_TOKEN if missing ──────────────────────────\n\nif [ -z \"\\${OPENCLAW_GATEWAY_TOKEN:-}\" ]; then\n  info \"Generating OPENCLAW_GATEWAY_TOKEN...\"\n  if command -v openssl &> /dev/null; then\n    OPENCLAW_GATEWAY_TOKEN=\"$(openssl rand -hex 32)\"\n  elif command -v python3 &> /dev/null; then\n    OPENCLAW_GATEWAY_TOKEN=\"$(python3 -c 'import secrets; print(secrets.token_hex(32))')\"\n  elif command -v python &> /dev/null; then\n    OPENCLAW_GATEWAY_TOKEN=\"$(python -c 'import secrets; print(secrets.token_hex(32))')\"\n  else\n    err \"Cannot generate token: neither openssl nor python3 found.\"\n    exit 1\n  fi\n  export OPENCLAW_GATEWAY_TOKEN\n\n  # Persist into .env\n  if [ -f \".env\" ]; then\n    if grep -q \"^OPENCLAW_GATEWAY_TOKEN=\" .env 2>/dev/null; then\n      sed -i.bak \"s|^OPENCLAW_GATEWAY_TOKEN=.*|OPENCLAW_GATEWAY_TOKEN=\\${OPENCLAW_GATEWAY_TOKEN}|\" .env && rm -f .env.bak\n    else\n      echo \"OPENCLAW_GATEWAY_TOKEN=\\${OPENCLAW_GATEWAY_TOKEN}\" >> .env\n    fi\n  fi\n  ok \"Gateway token generated and saved.\"\nfi\n\n# ── Apply defaults for optional variables ────────────────────────────────────\n\nexport OPENCLAW_VERSION=\"\\${OPENCLAW_VERSION:-latest}\"\nexport OPENCLAW_GATEWAY_PORT=\"\\${OPENCLAW_GATEWAY_PORT:-18789}\"\nexport OPENCLAW_BRIDGE_PORT=\"\\${OPENCLAW_BRIDGE_PORT:-18790}\"\nexport OPENCLAW_GATEWAY_BIND=\"\\${OPENCLAW_GATEWAY_BIND:-lan}\"\nexport OPENCLAW_CONFIG_DIR=\"\\${OPENCLAW_CONFIG_DIR:-./openclaw/config}\"\nexport OPENCLAW_WORKSPACE_DIR=\"\\${OPENCLAW_WORKSPACE_DIR:-./openclaw/workspace}\"\n\n# ── Create required host directories ────────────────────────────────────────\n\ninfo \"Ensuring host directories exist...\"\nmkdir -p \"\\${OPENCLAW_CONFIG_DIR}\"\nmkdir -p \"\\${OPENCLAW_WORKSPACE_DIR}\"\nok \"Directories ready: \\${OPENCLAW_CONFIG_DIR}, \\${OPENCLAW_WORKSPACE_DIR}\"\n\n# ── Check for empty secret values ────────────────────────────────────────────\n\nEMPTY_SECRETS=0\nwhile IFS='=' read -r key value; do\n  [[ \"$key\" =~ ^#.*$ ]] && continue\n  [[ -z \"$key\" ]] && continue\n  if [[ \"$key\" =~ (PASSWORD|TOKEN|SECRET|SESSION_KEY|COOKIE) ]] && [[ -z \"\\${value:-}\" ]]; then\n    warn \"Warning: $key is empty in .env\"\n    EMPTY_SECRETS=$((EMPTY_SECRETS + 1))\n  fi\ndone < .env 2>/dev/null || true\n\nif [ \"$EMPTY_SECRETS\" -gt 0 ]; then\n  echo \"\"\n  warn \"$EMPTY_SECRETS secret(s) are empty. Some services may not function until they are set.\"\n  echo \"\"\nfi\n\n# ── Pull and start ───────────────────────────────────────────────────────────\n\necho \"\"\ninfo \"Pulling latest images...\"\ndocker compose pull --quiet 2>/dev/null || docker compose pull\n\necho \"\"\ninfo \"Starting services...\"\ndocker compose up -d --remove-orphans\n\n# ── Health-check loop ────────────────────────────────────────────────────────\n\necho \"\"\ninfo \"Waiting for services to become healthy...\"\nsleep 5\n\nRETRIES=0\nMAX_RETRIES=30\nwhile [ $RETRIES -lt $MAX_RETRIES ]; do\n  UNHEALTHY=$(docker compose ps --format json 2>/dev/null | grep -c '\"unhealthy\"' || true)\n  STARTING=$(docker compose ps --format json 2>/dev/null | grep -c '\"starting\"' || true)\n\n  if [ \"$UNHEALTHY\" -eq 0 ] && [ \"$STARTING\" -eq 0 ]; then\n    break\n  fi\n\n  RETRIES=$((RETRIES + 1))\n  sleep 2\ndone\n\necho \"\"\ndocker compose ps\necho \"\"\n\nif [ $RETRIES -ge $MAX_RETRIES ]; then\n  warn \"Some services may still be starting. Check: docker compose ps\"\nelse\n  ok \"All services are running!\"\nfi\n\n# ── Print service URLs & token ───────────────────────────────────────────────\n\nGATEWAY_HOST=\"localhost\"\nif [ \"\\${OPENCLAW_GATEWAY_BIND}\" = \"lan\" ]; then\n  GATEWAY_HOST=\"0.0.0.0\"\nfi\n\necho \"\"\necho \"═══════════════════════════════════════════════════════════════════════════════\"\necho \" 🐾 OpenClaw is ready!\"\necho \"═══════════════════════════════════════════════════════════════════════════════\"\necho \"\"\necho \"  Gateway URL:        http://\\${GATEWAY_HOST}:\\${OPENCLAW_GATEWAY_PORT}\"\necho \"  Bridge (WebSocket): ws://\\${GATEWAY_HOST}:\\${OPENCLAW_BRIDGE_PORT}\"\necho \"  Config directory:   \\${OPENCLAW_CONFIG_DIR}\"\necho \"  Workspace directory:\\${OPENCLAW_WORKSPACE_DIR}\"\necho \"\"\necho \"  Gateway Token:      \\${OPENCLAW_GATEWAY_TOKEN}\"\necho \"\"\necho \"  Manage:\"\necho \"    Stop:   ./scripts/stop.sh\"\necho \"    Status: ./scripts/status.sh\"\necho \"    Update: ./scripts/update.sh\"\necho \"    Logs:   docker compose logs -f\"\necho \"\"\necho \"═══════════════════════════════════════════════════════════════════════════════\"\n`;\n\n\t// ── scripts/stop.sh ─────────────────────────────────────────────────────\n\n\tfiles[\"scripts/stop.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── OpenClaw Stop Script ───────────────────────────────────────────────────\n# Gracefully stops all services.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\ncd \"$PROJECT_DIR\"\n\necho \"🐾 OpenClaw — Stopping services...\"\necho \"\"\n\n# Graceful shutdown with timeout\ndocker compose down --timeout 30\n\necho \"\"\necho \"✅ All services stopped.\"\n`;\n\n\t// ── scripts/update.sh ───────────────────────────────────────────────────\n\n\tfiles[\"scripts/update.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── OpenClaw Update Script ─────────────────────────────────────────────────\n# Pulls latest images and restarts services.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\ncd \"$PROJECT_DIR\"\n\necho \"🐾 OpenClaw — Updating services...\"\necho \"\"\n\n# Pull latest images\necho \"📦 Pulling latest images...\"\ndocker compose pull\n\necho \"\"\necho \"🔄 Restarting services with new images...\"\ndocker compose up -d --remove-orphans\n\necho \"\"\necho \"⏳ Waiting for services to stabilize...\"\nsleep 10\n\ndocker compose ps\n\necho \"\"\necho \"✅ Update complete!\"\n`;\n\n\t// ── scripts/backup.sh ───────────────────────────────────────────────────\n\n\tfiles[\"scripts/backup.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── OpenClaw Backup Script ─────────────────────────────────────────────────\n# Backs up all named Docker volumes to a timestamped directory.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\ncd \"$PROJECT_DIR\"\n\nTIMESTAMP=$(date +%Y%m%d_%H%M%S)\nBACKUP_DIR=\"$PROJECT_DIR/backups/$TIMESTAMP\"\nmkdir -p \"$BACKUP_DIR\"\n\necho \"🐾 OpenClaw — Backing up volumes...\"\necho \"   Backup directory: $BACKUP_DIR\"\necho \"\"\n\n# Get project name from docker compose\nPROJECT_NAME=$(docker compose config --format json 2>/dev/null | grep -o '\"name\":\"[^\"]*\"' | head -1 | cut -d'\"' -f4 || echo \"openclaw\")\n\n# List all volumes for this project\nVOLUMES=$(docker volume ls --filter \"name=\\${PROJECT_NAME}\" --format \"{{.Name}}\" 2>/dev/null || true)\n\nif [ -z \"$VOLUMES\" ]; then\n  echo \"⚠️  No volumes found for project: $PROJECT_NAME\"\n  echo \"   Trying to list all openclaw volumes...\"\n  VOLUMES=$(docker volume ls --filter \"name=openclaw\" --format \"{{.Name}}\" 2>/dev/null || true)\nfi\n\nif [ -z \"$VOLUMES\" ]; then\n  echo \"❌ No volumes found to back up.\"\n  exit 1\nfi\n\nBACKED_UP=0\nfor VOLUME in $VOLUMES; do\n  echo \"📦 Backing up: $VOLUME\"\n  docker run --rm \\\\\n    -v \"\\${VOLUME}:/source:ro\" \\\\\n    -v \"$BACKUP_DIR:/backup\" \\\\\n    alpine tar czf \"/backup/\\${VOLUME}.tar.gz\" -C /source .\n\n  SIZE=$(du -sh \"$BACKUP_DIR/\\${VOLUME}.tar.gz\" | cut -f1)\n  echo \"   ✓ $VOLUME ($SIZE)\"\n  BACKED_UP=$((BACKED_UP + 1))\ndone\n\nTOTAL_SIZE=$(du -sh \"$BACKUP_DIR\" | cut -f1)\necho \"\"\necho \"✅ Backed up $BACKED_UP volume(s) ($TOTAL_SIZE total)\"\necho \"   Location: $BACKUP_DIR\"\n`;\n\n\t// ── scripts/status.sh ───────────────────────────────────────────────────\n\n\tfiles[\"scripts/status.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── OpenClaw Status Script ─────────────────────────────────────────────────\n# Shows the current status of all services.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\ncd \"$PROJECT_DIR\"\n\necho \"🐾 OpenClaw — Service Status\"\necho \"\"\n\n# Show compose status\ndocker compose ps\n\necho \"\"\necho \"── Resource Usage ──────────────────────────────────────────────────────\"\necho \"\"\n\n# Show resource usage\ndocker compose top 2>/dev/null || true\n\necho \"\"\necho \"── Disk Usage ─────────────────────────────────────────────────────────\"\necho \"\"\n\n# Show volume sizes\ndocker system df -v 2>/dev/null | head -30 || docker system df 2>/dev/null || true\n\necho \"\"\necho \"── Network ────────────────────────────────────────────────────────────\"\necho \"\"\n\ndocker network ls --filter \"name=openclaw\" --format \"table {{.Name}}\\\\t{{.Driver}}\\\\t{{.Scope}}\" 2>/dev/null || true\n`;\n\n\treturn files;\n}\n"],"mappings":";;;;;;;;AAKA,SAAgB,kBAA0C;CACzD,MAAM,QAAgC,EAAE;AAIxC,OAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsM5B,OAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;AAuB3B,OAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkC7B,OAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyD7B,OAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsC7B,QAAO"}

package/dist/generators/scripts.d.cts

@@ -0,0 +1,10 @@
+//#region src/generators/scripts.d.ts
+/**
+ * Generates helper shell scripts for managing the OpenClaw Docker Compose stack.
+ *
+ * Returns a map of file paths (relative to project root) to file contents.
+ */
+declare function generateScripts(): Record<string, string>;
+//#endregion
+export { generateScripts };
+//# sourceMappingURL=scripts.d.cts.map

package/dist/generators/scripts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.cts","names":[],"sources":["../../src/generators/scripts.ts"],"mappings":";;AAKA;;;;iBAAgB,eAAA,CAAA,GAAmB,MAAA"}

package/dist/generators/scripts.test.cjs

@@ -0,0 +1,51 @@
+const require_vi_2VT5v0um = require('../vi.2VT5v0um-BmRMvymT.cjs');
+const require_generators_scripts = require('./scripts.cjs');
+
+//#region src/generators/scripts.test.ts
+require_vi_2VT5v0um.describe("generateScripts", () => {
+	require_vi_2VT5v0um.it("generates all 5 expected scripts", () => {
+		const result = require_generators_scripts.generateScripts();
+		for (const script of [
+			"scripts/start.sh",
+			"scripts/stop.sh",
+			"scripts/update.sh",
+			"scripts/backup.sh",
+			"scripts/status.sh"
+		]) {
+			require_vi_2VT5v0um.globalExpect(result).toHaveProperty(script);
+			require_vi_2VT5v0um.globalExpect(result[script].length).toBeGreaterThan(0);
+		}
+	});
+	require_vi_2VT5v0um.it("start.sh calls docker compose up", () => {
+		const result = require_generators_scripts.generateScripts();
+		require_vi_2VT5v0um.globalExpect(result["scripts/start.sh"]).toContain("docker compose");
+		require_vi_2VT5v0um.globalExpect(result["scripts/start.sh"]).toContain("up");
+	});
+	require_vi_2VT5v0um.it("stop.sh calls docker compose down", () => {
+		const result = require_generators_scripts.generateScripts();
+		require_vi_2VT5v0um.globalExpect(result["scripts/stop.sh"]).toContain("docker compose");
+		require_vi_2VT5v0um.globalExpect(result["scripts/stop.sh"]).toContain("down");
+	});
+	require_vi_2VT5v0um.it("update.sh calls docker compose pull", () => {
+		const result = require_generators_scripts.generateScripts();
+		require_vi_2VT5v0um.globalExpect(result["scripts/update.sh"]).toContain("docker compose");
+		require_vi_2VT5v0um.globalExpect(result["scripts/update.sh"]).toContain("pull");
+	});
+	require_vi_2VT5v0um.it("backup.sh references volumes or backup", () => {
+		const backup = require_generators_scripts.generateScripts()["scripts/backup.sh"];
+		require_vi_2VT5v0um.globalExpect(backup).toBeDefined();
+		require_vi_2VT5v0um.globalExpect(backup.length).toBeGreaterThan(50);
+	});
+	require_vi_2VT5v0um.it("status.sh calls docker compose ps", () => {
+		const result = require_generators_scripts.generateScripts();
+		require_vi_2VT5v0um.globalExpect(result["scripts/status.sh"]).toContain("docker compose");
+		require_vi_2VT5v0um.globalExpect(result["scripts/status.sh"]).toContain("ps");
+	});
+	require_vi_2VT5v0um.it("all scripts start with bash shebang", () => {
+		const result = require_generators_scripts.generateScripts();
+		for (const [, content] of Object.entries(result)) require_vi_2VT5v0um.globalExpect(content.startsWith("#!/")).toBe(true);
+	});
+});
+
+//#endregion
+//# sourceMappingURL=scripts.test.cjs.map

package/dist/generators/scripts.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.test.cjs","names":["describe","generateScripts"],"sources":["../../src/generators/scripts.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { generateScripts } from \"./scripts.js\";\n\ndescribe(\"generateScripts\", () => {\n\tit(\"generates all 5 expected scripts\", () => {\n\t\tconst result = generateScripts();\n\n\t\tconst expectedScripts = [\n\t\t\t\"scripts/start.sh\",\n\t\t\t\"scripts/stop.sh\",\n\t\t\t\"scripts/update.sh\",\n\t\t\t\"scripts/backup.sh\",\n\t\t\t\"scripts/status.sh\",\n\t\t];\n\n\t\tfor (const script of expectedScripts) {\n\t\t\texpect(result).toHaveProperty(script);\n\t\t\texpect(result[script]!.length).toBeGreaterThan(0);\n\t\t}\n\t});\n\n\tit(\"start.sh calls docker compose up\", () => {\n\t\tconst result = generateScripts();\n\t\texpect(result[\"scripts/start.sh\"]).toContain(\"docker compose\");\n\t\texpect(result[\"scripts/start.sh\"]).toContain(\"up\");\n\t});\n\n\tit(\"stop.sh calls docker compose down\", () => {\n\t\tconst result = generateScripts();\n\t\texpect(result[\"scripts/stop.sh\"]).toContain(\"docker compose\");\n\t\texpect(result[\"scripts/stop.sh\"]).toContain(\"down\");\n\t});\n\n\tit(\"update.sh calls docker compose pull\", () => {\n\t\tconst result = generateScripts();\n\t\texpect(result[\"scripts/update.sh\"]).toContain(\"docker compose\");\n\t\texpect(result[\"scripts/update.sh\"]).toContain(\"pull\");\n\t});\n\n\tit(\"backup.sh references volumes or backup\", () => {\n\t\tconst result = generateScripts();\n\t\tconst backup = result[\"scripts/backup.sh\"]!;\n\t\texpect(backup).toBeDefined();\n\t\texpect(backup.length).toBeGreaterThan(50);\n\t});\n\n\tit(\"status.sh calls docker compose ps\", () => {\n\t\tconst result = generateScripts();\n\t\texpect(result[\"scripts/status.sh\"]).toContain(\"docker compose\");\n\t\texpect(result[\"scripts/status.sh\"]).toContain(\"ps\");\n\t});\n\n\tit(\"all scripts start with bash shebang\", () => {\n\t\tconst result = generateScripts();\n\n\t\tfor (const [, content] of Object.entries(result)) {\n\t\t\texpect(content.startsWith(\"#!/\")).toBe(true);\n\t\t}\n\t});\n});\n"],"mappings":";;;;AAGAA,6BAAS,yBAAyB;AACjC,wBAAG,0CAA0C;EAC5C,MAAM,SAASC,4CAAiB;AAUhC,OAAK,MAAM,UARa;GACvB;GACA;GACA;GACA;GACA;GACA,EAEqC;AACrC,oCAAO,OAAO,CAAC,eAAe,OAAO;AACrC,oCAAO,OAAO,QAAS,OAAO,CAAC,gBAAgB,EAAE;;GAEjD;AAEF,wBAAG,0CAA0C;EAC5C,MAAM,SAASA,4CAAiB;AAChC,mCAAO,OAAO,oBAAoB,CAAC,UAAU,iBAAiB;AAC9D,mCAAO,OAAO,oBAAoB,CAAC,UAAU,KAAK;GACjD;AAEF,wBAAG,2CAA2C;EAC7C,MAAM,SAASA,4CAAiB;AAChC,mCAAO,OAAO,mBAAmB,CAAC,UAAU,iBAAiB;AAC7D,mCAAO,OAAO,mBAAmB,CAAC,UAAU,OAAO;GAClD;AAEF,wBAAG,6CAA6C;EAC/C,MAAM,SAASA,4CAAiB;AAChC,mCAAO,OAAO,qBAAqB,CAAC,UAAU,iBAAiB;AAC/D,mCAAO,OAAO,qBAAqB,CAAC,UAAU,OAAO;GACpD;AAEF,wBAAG,gDAAgD;EAElD,MAAM,SADSA,4CAAiB,CACV;AACtB,mCAAO,OAAO,CAAC,aAAa;AAC5B,mCAAO,OAAO,OAAO,CAAC,gBAAgB,GAAG;GACxC;AAEF,wBAAG,2CAA2C;EAC7C,MAAM,SAASA,4CAAiB;AAChC,mCAAO,OAAO,qBAAqB,CAAC,UAAU,iBAAiB;AAC/D,mCAAO,OAAO,qBAAqB,CAAC,UAAU,KAAK;GAClD;AAEF,wBAAG,6CAA6C;EAC/C,MAAM,SAASA,4CAAiB;AAEhC,OAAK,MAAM,GAAG,YAAY,OAAO,QAAQ,OAAO,CAC/C,kCAAO,QAAQ,WAAW,MAAM,CAAC,CAAC,KAAK,KAAK;GAE5C;EACD"}

package/dist/generators/scripts.test.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/generators/scripts.test.mjs

@@ -1,4 +1,4 @@
-import { n as describe, r as it, t as globalExpect } from "../vi.2VT5v0um-BgmKutxR.mjs";
+import { n as describe, r as it, t as globalExpect } from "../vi.2VT5v0um-CFyDIn0m.mjs";
 import { generateScripts } from "./scripts.mjs";
 
 //#region src/generators/scripts.test.ts