Pilot S3 Bridge#

Bridges Pilot Protocol with cloud storage services (AWS S3, Google Cloud Storage, Azure Blob Storage), enabling agents to upload, download, and manage files through a gateway agent with cloud access.

Commands#

Upload File via Bridge#

bash

pilotctl --json send-file s3-agent /path/to/local/file.pdf

Request Download from S3#

bash

pilotctl --json send-message s3-agent --data '{"action":"download","bucket":"my-bucket","key":"documents/file.pdf"}'

List S3 Objects#

bash

pilotctl --json send-message s3-agent --data '{"action":"list","bucket":"my-bucket","prefix":"documents/"}'

Check Received Files#

bash

pilotctl --json received
pilotctl --json received --clear

Request Presigned URL#

bash

pilotctl --json send-message s3-agent --data '{"action":"presign","bucket":"my-bucket","key":"public/image.png","expires":3600}'

Workflow Example#

bash

#!/bin/bash
# S3 bridge agent setup

pilotctl --json daemon start --hostname s3-agent --public
pilotctl --json listen 1008

export AWS_ACCESS_KEY_ID="your_key"
export AWS_SECRET_ACCESS_KEY="your_secret"

while true; do
  REQUEST=$(pilotctl --json recv 1008 --timeout 120s)
  ACTION=$(echo "$REQUEST" | jq -r '.action')
  SENDER=$(echo "$REQUEST" | jq -r '.sender')
  BUCKET=$(echo "$REQUEST" | jq -r '.bucket')
  KEY=$(echo "$REQUEST" | jq -r '.key')

  case "$ACTION" in
    upload)
      pilotctl --json received > /tmp/upload_file
      aws s3 cp /tmp/upload_file "s3://$BUCKET/$KEY"
      pilotctl --json send-message "$SENDER" --data '{"status":"uploaded"}'
      ;;
    download)
      aws s3 cp "s3://$BUCKET/$KEY" /tmp/download_file
      pilotctl --json send-file "$SENDER" /tmp/download_file
      ;;
    list)
      OBJECTS=$(aws s3 ls "s3://$BUCKET/$(echo "$REQUEST" | jq -r '.prefix')" --recursive)
      pilotctl --json send-message "$SENDER" --data "$OBJECTS"
      ;;
  esac
done

Dependencies#

Requires pilot-protocol skill, running daemon, S3 bridge agent with cloud credentials (AWS CLI, gsutil, or az CLI).