node ./skillboss/scripts/api-hub.js chat --model "bedrock/claude-4-6-opus" --prompt "Solve this complex reasoning problem"
node ./skillboss/scripts/api-hub.js chat --model "bedrock/claude-4-5-sonnet" --prompt "Explain quantum computing"
node ./skillboss/scripts/api-hub.js chat --model "openai/gpt-5" --prompt "Write a haiku" --stream

# Chat - any text-generation model works
node ./skillboss/scripts/api-hub.js chat --model "huggingface/meta-llama/Llama-3.1-8B-Instruct" --prompt "Hello"
node ./skillboss/scripts/api-hub.js chat --model "huggingface/zai-org/GLM-5" --prompt "Hello" --stream

# Other tasks via /run with task parameter
node ./skillboss/scripts/api-hub.js run --model "huggingface/BAAI/bge-small-en-v1.5" --inputs '{"task":"embedding","input":"hello world"}'
node ./skillboss/scripts/api-hub.js run --model "huggingface/stabilityai/stable-diffusion-xl-base-1.0" --inputs '{"inputs":"a sunset"}' --output /tmp/image.png
node ./skillboss/scripts/api-hub.js stt --file recording.mp3 --model "huggingface/openai/whisper-large-v3"

node ./skillboss/scripts/api-hub.js image --prompt "A sunset over mountains"
# Uses mm/img by default. To save locally:
node ./skillboss/scripts/api-hub.js image --prompt "A sunset over mountains" --output /tmp/sunset.png

node ./skillboss/scripts/api-hub.js upscale --image-url "https://example.com/photo.jpg" --output /tmp/upscaled.png
node ./skillboss/scripts/api-hub.js upscale --image-url "https://example.com/photo.jpg" --scale 4 --output /tmp/upscaled.png

node ./skillboss/scripts/api-hub.js img2img --image-url "https://example.com/photo.jpg" --prompt "watercolor painting" --output /tmp/result.jpg

# Text-to-video (uses mm/t2v by default)
node ./skillboss/scripts/api-hub.js video --prompt "A cat playing with a ball" --output /tmp/cat.mp4

# Image-to-video (uses mm/i2v when --image provided)
node ./skillboss/scripts/api-hub.js video --prompt "Animate this scene" --image "https://example.com/image.png" --output /tmp/animated.mp4

node ./skillboss/scripts/api-hub.js document --model "reducto/parse" --url "https://example.com/doc.pdf"
node ./skillboss/scripts/api-hub.js document --model "reducto/extract" --url "https://example.com/doc.pdf" --schema '{"type":"object","properties":{"title":{"type":"string","description":"Document title"}}}'

node ./skillboss/scripts/api-hub.js tts --model "minimax/speech-01-turbo" --text "Hello world" --output /tmp/hello.mp3

node ./skillboss/scripts/api-hub.js stt --file recording.mp3
node ./skillboss/scripts/api-hub.js stt --file interview.wav --language en --output /tmp/transcript.txt

# Step 1: Send OTP code to phone number
node ./skillboss/scripts/api-hub.js sms-verify --phone "+1234567890"

# Step 2: Check the code (after user receives it)
node ./skillboss/scripts/api-hub.js sms-check --phone "+1234567890" --code "123456"

node ./skillboss/scripts/api-hub.js sms-send --phone "+1234567890" --template-id "your_template_id"

node ./skillboss/scripts/api-hub.js music --prompt "upbeat electronic dance track"

node ./skillboss/scripts/api-hub.js music --prompt "calm acoustic guitar" --output /tmp/guitar.mp3

# With specific model:
node ./skillboss/scripts/api-hub.js music --model "replicate/meta/musicgen" --prompt "epic orchestral soundtrack" --duration 60

node ./skillboss/scripts/api-hub.js linkup-search --query "latest AI news"
node ./skillboss/scripts/api-hub.js linkup-search --query "compare React vs Vue" --output-type sourcedAnswer --depth deep
node ./skillboss/scripts/api-hub.js linkup-fetch --url "https://example.com"

node ./skillboss/scripts/api-hub.js send-email --to "user@example.com" --subject "Hello" --body "<p>Hi there!</p>"

node ./skillboss/scripts/serve-build.js publish-static ./dist

node ./skillboss/scripts/serve-build.js publish-worker ./worker

node ./skillboss/scripts/stripe-connect.js

node ./skillboss/scripts/api-hub.js send-email --to "a@b.com,c@d.com" --subject "Update" --body "<p>Content here</p>"

node ./skillboss/scripts/api-hub.js send-batch \
  --subject "Hi {{name}}" \
  --body "<p>Hello {{name}}, order #{{order_id}} ready.</p>" \
  --receivers '[{"email":"alice@b.com","variables":{"name":"Alice","order_id":"123"}}]'

node ./skillboss/scripts/api-hub.js version

bash ./skillboss/install/update.sh

.\skillboss\install\update.ps1

{
  "_balance_warning": "Warning: Your balance is very low (3.5 credits). Please visit https://www.skillboss.co/ to add credits."
}

Your SkillBoss credits have run out.

To continue using the service, please visit https://www.skillboss.co/ to:
1. Subscribe to a plan
2. Purchase additional credits
3. Enable auto-topup in your account settings

After adding credits, retry the command.

Your SkillBoss API key is invalid or expired.

Please visit https://www.skillboss.co/ to:
1. Log in to your account
2. Download a fresh skills pack with a new API key

Your Worker  ──▶  shopping.heybossai.com  ──▶  Stripe
    │                    │
    │                    └─── Handles webhooks, subscriptions, refunds
    ▼
HeyBoss Dashboard (Product Management)

node ./skillboss/scripts/stripe-connect.js

cp -r ./skillboss/templates/worker-ecommerce ./my-store

node ./skillboss/scripts/serve-build.js publish-worker ./worker

name = "my-api"
main = "src/index.ts"
compatibility_date = "2024-01-01"

[[d1_databases]]
binding = "DB"
database_name = "my-db"

[vars]
API_VERSION = "1.0"

# Build your React app first
npm run build

# Deploy Worker + React app together
node ./skillboss/scripts/serve-build.js publish-worker . --name my-fullstack-app

// Environment variable setup
// Add to .env: SKILLBOSS_API_KEY=<key from skillboss/config.json>

const SKILLBOSS_API_KEY = process.env.SKILLBOSS_API_KEY
const API_BASE = 'https://api.heybossai.com/v1'

// ============================================================================
// CHAT COMPLETION
// ============================================================================
async function chat(prompt: string): Promise<string> {
  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model: 'bedrock/claude-4-5-sonnet', // or bedrock/claude-4-6-opus, openai/gpt-5, vertex/gemini-2.5-flash
      inputs: {
        messages: [{ role: 'user', content: prompt }]
      }
    })
  })
  const data = await response.json()

  // Response parsing - handle multiple formats
  const text = data.choices?.[0]?.message?.content  // OpenAI/Bedrock format
            || data.content?.[0]?.text               // Anthropic format
            || data.message?.content                 // Alternative format
  return text
}

// ============================================================================
// IMAGE GENERATION
// ============================================================================
async function generateImage(prompt: string, size?: string): Promise<string> {
  const model = 'mm/img' // Default model, or use vertex/gemini-3-pro-image-preview

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model,
      inputs: {
        prompt,
        size: size || '1024*768'  // MM format: "width*height", default 4:3 landscape
      }
    })
  })
  const data = await response.json()

  // MM response format: {image_url: "https://..."}
  return data.image_url
}

// ============================================================================
// TEXT-TO-SPEECH
// ============================================================================
async function textToSpeech(text: string): Promise<ArrayBuffer> {
  const model = 'minimax/speech-01-turbo' // or elevenlabs/eleven_multilingual_v2, openai/tts-1
  const [vendor] = model.split('/')

  // Request format varies by vendor
  let inputs: Record<string, unknown>
  if (vendor === 'elevenlabs') {
    inputs = { text, voice_id: 'EXAVITQu4vr4xnSDxMaL' }   // Rachel voice
  } else if (vendor === 'minimax') {
    inputs = { text, voice_setting: { voice_id: 'male-qn-qingse', speed: 1.0, vol: 1.0, pitch: 0 } }
  } else if (vendor === 'openai') {
    inputs = { input: text, voice: 'alloy' }
  } else {
    inputs = { text }
  }

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({ model, inputs })
  })

  // Response is binary audio data
  return response.arrayBuffer()
}

// ============================================================================
// SPEECH-TO-TEXT
// ============================================================================
async function speechToText(audioBuffer: ArrayBuffer, filename: string): Promise<string> {
  const base64Audio = Buffer.from(audioBuffer).toString('base64')

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model: 'openai/whisper-1',
      inputs: {
        audio_data: base64Audio,
        filename  // e.g., "recording.mp3"
      }
    })
  })
  const data = await response.json()

  // Response: {text: "transcribed text here"}
  return data.text
}

// ============================================================================
// MUSIC GENERATION
// ============================================================================
async function generateMusic(prompt: string, duration?: number): Promise<string> {
  const model = 'replicate/elevenlabs/music' // or replicate/meta/musicgen, replicate/google/lyria-2

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model,
      inputs: {
        prompt,
        duration: duration || 30  // seconds
      }
    })
  })
  const data = await response.json()

  // Response: {audio_url: "https://...", duration_seconds: 30}
  return data.audio_url
}

// ============================================================================
// VIDEO GENERATION
// ============================================================================
// Text-to-video
async function generateVideo(prompt: string, duration?: number): Promise<string> {
  const model = 'mm/t2v' // Default for text-to-video

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model,
      inputs: {
        prompt,
        duration: duration || 5  // seconds
      }
    })
  })
  const data = await response.json()

  // MM response format: {video_url: "https://..."}
  return data.video_url
}

// Image-to-video
async function imageToVideo(prompt: string, imageUrl: string, duration?: number): Promise<string> {
  const model = 'mm/i2v' // Default for image-to-video

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model,
      inputs: {
        prompt,
        image: imageUrl,
        duration: duration || 5  // seconds
      }
    })
  })
  const data = await response.json()

  // MM response format: {video_url: "https://..."}
  return data.video_url
}

// ============================================================================
// DOCUMENT PROCESSING
// ============================================================================
async function parseDocument(url: string): Promise<object> {
  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model: 'reducto/parse',
      inputs: { document_url: url }
    })
  })
  return response.json()
  // Response: { result: { blocks: [...], ... }, usage: { credits: N } }
}

// ============================================================================
// SMS VERIFICATION (Prelude)
// ============================================================================
// Step 1: Send OTP code
async function sendVerificationCode(phoneNumber: string, ip?: string): Promise<object> {
  const inputs: Record<string, unknown> = {
    target: { type: 'phone_number', value: phoneNumber }
  }
  if (ip) inputs.signals = { ip }

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({ model: 'prelude/verify-send', inputs })
  })
  return response.json()
  // Response: { id: "vrf_...", status: "success", method: "message", channels: ["sms"] }
}

// Step 2: Verify OTP code
async function checkVerificationCode(phoneNumber: string, code: string): Promise<object> {
  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model: 'prelude/verify-check',
      inputs: {
        target: { type: 'phone_number', value: phoneNumber },
        code
      }
    })
  })
  return response.json()
  // Response: { id: "vrf_...", status: "success" }  (or "failure" / "expired_or_not_found")
}

// Send SMS notification (requires template configured in Prelude dashboard)
async function sendSmsNotification(phoneNumber: string, templateId: string, variables?: Record<string, string>): Promise<object> {
  const inputs: Record<string, unknown> = {
    template_id: templateId,
    to: phoneNumber
  }
  if (variables) inputs.variables = variables

  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({ model: 'prelude/notify-send', inputs })
  })
  return response.json()
}

async function extractFromDocument(url: string, schema: object): Promise<object> {
  const response = await fetch(`${API_BASE}/run`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${SKILLBOSS_API_KEY}`
    },
    body: JSON.stringify({
      model: 'reducto/extract',
      inputs: {
        document_url: url,
        instructions: { schema }  // JSON Schema for fields to extract
      }
    })
  })
  return response.json()
  // Response: { result: { ...extracted fields }, usage: { credits: N } }
}

## Available Skills
- `/skillboss` - Deploy static sites, send emails, call 50+ AI models (chat, image, TTS, video)