@hummingbot/skills 1.0.0

package/skills/executor-creator/scripts/create_executor.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+# Create and start a new executor
+# Usage: ./create_executor.sh --type EXECUTOR_TYPE --config JSON [--account ACCOUNT]
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+EXECUTOR_TYPE=""
+CONFIG=""
+ACCOUNT="master_account"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --type) EXECUTOR_TYPE="$2"; shift 2 ;;
+        --config) CONFIG="$2"; shift 2 ;;
+        --account) ACCOUNT="$2"; shift 2 ;;
+        --connector) CONNECTOR="$2"; shift 2 ;;
+        --pair) PAIR="$2"; shift 2 ;;
+        --side) SIDE="$2"; shift 2 ;;
+        --amount) AMOUNT="$2"; shift 2 ;;
+        --stop-loss) STOP_LOSS="$2"; shift 2 ;;
+        --take-profit) TAKE_PROFIT="$2"; shift 2 ;;
+        --time-limit) TIME_LIMIT="$2"; shift 2 ;;
+        --entry-price) ENTRY_PRICE="$2"; shift 2 ;;
+        --lower-price) LOWER_PRICE="$2"; shift 2 ;;
+        --upper-price) UPPER_PRICE="$2"; shift 2 ;;
+        --levels) LEVELS="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if [ -z "$EXECUTOR_TYPE" ]; then
+    echo '{"error": "executor type is required. Use --type EXECUTOR_TYPE"}'
+    exit 1
+fi
+
+# Build config from individual params if not provided as JSON
+if [ -z "$CONFIG" ]; then
+    CONFIG="{\"type\": \"$EXECUTOR_TYPE\""
+
+    [ -n "$CONNECTOR" ] && CONFIG+=", \"connector_name\": \"$CONNECTOR\""
+    [ -n "$PAIR" ] && CONFIG+=", \"trading_pair\": \"$PAIR\""
+    [ -n "$SIDE" ] && CONFIG+=", \"side\": \"$SIDE\""
+    [ -n "$AMOUNT" ] && CONFIG+=", \"amount\": $AMOUNT"
+    [ -n "$ENTRY_PRICE" ] && CONFIG+=", \"entry_price\": $ENTRY_PRICE"
+    [ -n "$STOP_LOSS" ] && CONFIG+=", \"stop_loss\": $STOP_LOSS"
+    [ -n "$TAKE_PROFIT" ] && CONFIG+=", \"take_profit\": $TAKE_PROFIT"
+    [ -n "$TIME_LIMIT" ] && CONFIG+=", \"time_limit\": $TIME_LIMIT"
+    [ -n "$LOWER_PRICE" ] && CONFIG+=", \"start_price\": $LOWER_PRICE"
+    [ -n "$UPPER_PRICE" ] && CONFIG+=", \"end_price\": $UPPER_PRICE"
+    [ -n "$LEVELS" ] && CONFIG+=", \"total_levels\": $LEVELS"
+
+    CONFIG+="}"
+else
+    # Ensure type is in the config
+    CONFIG=$(echo "$CONFIG" | jq --arg type "$EXECUTOR_TYPE" '. + {type: $type}')
+fi
+
+# Build request
+REQUEST=$(jq -n \
+    --argjson config "$CONFIG" \
+    --arg account "$ACCOUNT" \
+    '{executor_config: $config, account_name: $account}')
+
+# Create executor
+RESPONSE=$(curl -s -X POST \
+    -u "$API_USER:$API_PASS" \
+    -H "Content-Type: application/json" \
+    -d "$REQUEST" \
+    "$API_URL/executors")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to create executor\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+cat << EOF
+{
+    "status": "success",
+    "action": "executor_created",
+    "executor_type": "$EXECUTOR_TYPE",
+    "account": "$ACCOUNT",
+    "response": $RESPONSE
+}
+EOF

package/skills/executor-creator/scripts/get_executor.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Get details for a specific executor
+# Usage: ./get_executor.sh --id EXECUTOR_ID
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+EXECUTOR_ID=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --id) EXECUTOR_ID="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if [ -z "$EXECUTOR_ID" ]; then
+    echo '{"error": "executor ID is required. Use --id EXECUTOR_ID"}'
+    exit 1
+fi
+
+# Fetch executor details
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/$EXECUTOR_ID")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get executor '$EXECUTOR_ID'\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/get_executor_schema.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Get configuration schema for a specific executor type
+# Usage: ./get_executor_schema.sh --type EXECUTOR_TYPE
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+EXECUTOR_TYPE=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --type) EXECUTOR_TYPE="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if [ -z "$EXECUTOR_TYPE" ]; then
+    echo '{"error": "executor type is required. Use --type EXECUTOR_TYPE"}'
+    exit 1
+fi
+
+# Fetch schema
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/types/$EXECUTOR_TYPE/config")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get schema for '$EXECUTOR_TYPE'\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/get_executors_summary.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Get summary statistics for all executors
+# Usage: ./get_executors_summary.sh
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+# Fetch summary
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/summary")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get executors summary\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/get_position.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Get a specific held position
+# Usage: ./get_position.sh --connector CONNECTOR --pair PAIR
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+CONNECTOR=""
+PAIR=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --connector) CONNECTOR="$2"; shift 2 ;;
+        --pair) PAIR="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if [ -z "$CONNECTOR" ]; then
+    echo '{"error": "connector is required. Use --connector CONNECTOR"}'
+    exit 1
+fi
+
+if [ -z "$PAIR" ]; then
+    echo '{"error": "trading pair is required. Use --pair PAIR"}'
+    exit 1
+fi
+
+# Fetch position
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/positions/$CONNECTOR/$PAIR")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get position for $CONNECTOR/$PAIR\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/get_positions.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Get all held positions from stopped executors
+# Usage: ./get_positions.sh
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+# Fetch positions summary
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/positions/summary")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get positions\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/list_executor_types.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# List available executor types with descriptions
+# Usage: ./list_executor_types.sh
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+# Fetch executor types
+RESPONSE=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/types/available")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to get executor types\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/list_executors.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# List executors with optional filtering
+# Usage: ./list_executors.sh [--status STATUS] [--connector CONNECTOR] [--pair PAIR] [--type TYPE]
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+STATUS=""
+CONNECTOR=""
+PAIR=""
+EXECUTOR_TYPE=""
+LIMIT=50
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --status) STATUS="$2"; shift 2 ;;
+        --connector) CONNECTOR="$2"; shift 2 ;;
+        --pair) PAIR="$2"; shift 2 ;;
+        --type) EXECUTOR_TYPE="$2"; shift 2 ;;
+        --limit) LIMIT="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+# Build filter request
+FILTER="{\"limit\": $LIMIT"
+[ -n "$STATUS" ] && FILTER+=", \"status\": \"$STATUS\""
+[ -n "$CONNECTOR" ] && FILTER+=", \"connector_names\": [\"$CONNECTOR\"]"
+[ -n "$PAIR" ] && FILTER+=", \"trading_pairs\": [\"$PAIR\"]"
+[ -n "$EXECUTOR_TYPE" ] && FILTER+=", \"executor_types\": [\"$EXECUTOR_TYPE\"]"
+FILTER+="}"
+
+# Search executors
+RESPONSE=$(curl -s -X POST \
+    -u "$API_USER:$API_PASS" \
+    -H "Content-Type: application/json" \
+    -d "$FILTER" \
+    "$API_URL/executors/search")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to list executors\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+echo "$RESPONSE" | jq '.'

package/skills/executor-creator/scripts/setup_executor.sh

@@ -0,0 +1,197 @@
+#!/bin/bash
+# Create executor with progressive disclosure
+#
+# Flow:
+# 1. No parameters → List available executor types
+# 2. --type only → Show config schema for that type
+# 3. --type + --config → Create and start the executor
+#
+# Usage:
+#   ./setup_executor.sh                                     # Step 1: List executor types
+#   ./setup_executor.sh --type position_executor            # Step 2: Show config schema
+#   ./setup_executor.sh --type position_executor --config '{...}'  # Step 3: Create executor
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+EXECUTOR_TYPE=""
+CONFIG=""
+ACCOUNT="master_account"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --type) EXECUTOR_TYPE="$2"; shift 2 ;;
+        --config) CONFIG="$2"; shift 2 ;;
+        --account) ACCOUNT="$2"; shift 2 ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+# Determine flow stage
+if [ -z "$EXECUTOR_TYPE" ]; then
+    STAGE="list_types"
+elif [ -z "$CONFIG" ]; then
+    STAGE="show_schema"
+else
+    STAGE="create"
+fi
+
+case "$STAGE" in
+    list_types)
+        # Step 1: List available executor types
+        TYPES=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/types/available")
+
+        if echo "$TYPES" | jq -e '.detail' > /dev/null 2>&1; then
+            echo "{\"error\": \"Failed to get executor types\", \"detail\": $TYPES}"
+            exit 1
+        fi
+
+        # Get current executor summary
+        SUMMARY=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/summary")
+
+        cat << EOF
+{
+    "action": "list_types",
+    "message": "Available executor types. Select one to see its configuration schema.",
+    "executor_types": $(echo "$TYPES" | jq '.executor_types'),
+    "current_summary": {
+        "active": $(echo "$SUMMARY" | jq '.total_active'),
+        "completed": $(echo "$SUMMARY" | jq '.total_completed'),
+        "total_pnl": $(echo "$SUMMARY" | jq '.total_pnl_quote')
+    },
+    "next_step": "Call again with --type EXECUTOR_TYPE to see the configuration schema",
+    "example": "./setup_executor.sh --type position_executor"
+}
+EOF
+        ;;
+
+    show_schema)
+        # Step 2: Show configuration schema for the executor type
+        SCHEMA=$(curl -s -u "$API_USER:$API_PASS" "$API_URL/executors/types/$EXECUTOR_TYPE/config")
+
+        if echo "$SCHEMA" | jq -e '.detail' > /dev/null 2>&1; then
+            echo "{\"error\": \"Executor type '$EXECUTOR_TYPE' not found\", \"detail\": $SCHEMA}"
+            exit 1
+        fi
+
+        # Extract required and optional fields
+        REQUIRED_FIELDS=$(echo "$SCHEMA" | jq '[.fields[] | select(.required == true and .default == null) | .name]')
+        OPTIONAL_FIELDS=$(echo "$SCHEMA" | jq '[.fields[] | select(.required != true or .default != null) | {name: .name, default: .default}]')
+
+        # Build minimal example config
+        EXAMPLE_CONFIG=$(echo "$SCHEMA" | jq --arg type "$EXECUTOR_TYPE" '
+            {type: $type} +
+            ([.fields[] | select(.required == true and .default == null) |
+                {(.name): (
+                    if .type == "string" then "your_" + .name
+                    elif .type == "number" then 0
+                    elif .type == "boolean" then false
+                    else "your_" + .name
+                    end
+                )}
+            ] | add // {})
+        ')
+
+        # Build a more complete example for position_executor
+        if [ "$EXECUTOR_TYPE" = "position_executor" ]; then
+            EXAMPLE_CONFIG='{
+    "type": "position_executor",
+    "connector_name": "hyperliquid_perpetual",
+    "trading_pair": "BTC-USD",
+    "side": "BUY",
+    "amount": "0.001",
+    "triple_barrier_config": {
+        "stop_loss": "0.02",
+        "take_profit": "0.04",
+        "time_limit": 3600
+    }
+}'
+        elif [ "$EXECUTOR_TYPE" = "grid_executor" ]; then
+            EXAMPLE_CONFIG='{
+    "type": "grid_executor",
+    "connector_name": "hyperliquid_perpetual",
+    "trading_pair": "BTC-USD",
+    "start_price": "80000",
+    "end_price": "90000",
+    "total_amount_quote": "1000",
+    "total_levels": 10,
+    "side": "BUY"
+}'
+        elif [ "$EXECUTOR_TYPE" = "dca_executor" ]; then
+            EXAMPLE_CONFIG='{
+    "type": "dca_executor",
+    "connector_name": "hyperliquid_perpetual",
+    "trading_pair": "BTC-USD",
+    "side": "BUY",
+    "total_amount_quote": "1000",
+    "n_levels": 5,
+    "time_limit": 86400
+}'
+        fi
+
+        cat << EOF
+{
+    "action": "show_schema",
+    "message": "Configuration schema for $EXECUTOR_TYPE. Build your config and create the executor.",
+    "executor_type": "$EXECUTOR_TYPE",
+    "description": $(echo "$SCHEMA" | jq '.description'),
+    "required_fields": $REQUIRED_FIELDS,
+    "all_fields": $(echo "$SCHEMA" | jq '[.fields[] | {name: .name, type: .type, required: .required, default: .default, description: .description}]'),
+    "example_config": $EXAMPLE_CONFIG,
+    "next_step": "Call again with --config JSON to create the executor",
+    "example": "./setup_executor.sh --type $EXECUTOR_TYPE --config '\$EXAMPLE_CONFIG'"
+}
+EOF
+        ;;
+
+    create)
+        # Step 3: Create and start the executor
+
+        # Ensure type is in the config
+        CONFIG_WITH_TYPE=$(echo "$CONFIG" | jq --arg type "$EXECUTOR_TYPE" '. + {type: $type}')
+
+        # Build request
+        REQUEST=$(jq -n \
+            --argjson config "$CONFIG_WITH_TYPE" \
+            --arg account "$ACCOUNT" \
+            '{executor_config: $config, account_name: $account}')
+
+        # Create executor
+        RESPONSE=$(curl -s -X POST \
+            -u "$API_USER:$API_PASS" \
+            -H "Content-Type: application/json" \
+            -d "$REQUEST" \
+            "$API_URL/executors")
+
+        if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+            echo "{\"error\": \"Failed to create executor\", \"detail\": $RESPONSE}"
+            exit 1
+        fi
+
+        # Extract key info from response
+        EXECUTOR_ID=$(echo "$RESPONSE" | jq -r '.id // .executor_id // "unknown"')
+
+        cat << EOF
+{
+    "action": "executor_created",
+    "message": "Successfully created and started $EXECUTOR_TYPE",
+    "executor_id": "$EXECUTOR_ID",
+    "executor_type": "$EXECUTOR_TYPE",
+    "account": "$ACCOUNT",
+    "config": $CONFIG_WITH_TYPE,
+    "response": $RESPONSE,
+    "next_steps": [
+        "Monitor with: ./get_executor.sh --id $EXECUTOR_ID",
+        "Stop with: ./stop_executor.sh --id $EXECUTOR_ID",
+        "List all: ./list_executors.sh"
+    ]
+}
+EOF
+        ;;
+esac

package/skills/executor-creator/scripts/stop_executor.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Stop a running executor
+# Usage: ./stop_executor.sh --id EXECUTOR_ID [--keep-position]
+
+set -e
+
+API_URL="${API_URL:-http://localhost:8000}"
+API_USER="${API_USER:-admin}"
+API_PASS="${API_PASS:-admin}"
+EXECUTOR_ID=""
+KEEP_POSITION=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --id) EXECUTOR_ID="$2"; shift 2 ;;
+        --keep-position) KEEP_POSITION=true; shift ;;
+        --api-url) API_URL="$2"; shift 2 ;;
+        --api-user) API_USER="$2"; shift 2 ;;
+        --api-pass) API_PASS="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if [ -z "$EXECUTOR_ID" ]; then
+    echo '{"error": "executor ID is required. Use --id EXECUTOR_ID"}'
+    exit 1
+fi
+
+# Build request body
+REQUEST=$(jq -n --argjson keep "$KEEP_POSITION" '{keep_position: $keep}')
+
+# Stop executor
+RESPONSE=$(curl -s -X POST \
+    -u "$API_USER:$API_PASS" \
+    -H "Content-Type: application/json" \
+    -d "$REQUEST" \
+    "$API_URL/executors/$EXECUTOR_ID/stop")
+
+# Check for error
+if echo "$RESPONSE" | jq -e '.detail' > /dev/null 2>&1; then
+    echo "{\"error\": \"Failed to stop executor '$EXECUTOR_ID'\", \"detail\": $RESPONSE}"
+    exit 1
+fi
+
+cat << EOF
+{
+    "status": "success",
+    "action": "executor_stopped",
+    "executor_id": "$EXECUTOR_ID",
+    "keep_position": $KEEP_POSITION,
+    "response": $RESPONSE
+}
+EOF