Boat Scan

Check type === "boat_scan" and action === "generate_episode", then follow the workflow below.

Later episodes include priorCaptures — photos, videos, and voice memos from all previous episodes. Use them to personalize your script.

Workflow

Step 1: Write the script

Write a 150-200 word podcast-style script talking directly to the captain.

Use everything you have:

• Captain's name and boat name/model/year
• Episode focus area
• Prior captures — reference specific things you saw or heard
• Your Stoolap knowledge DB — query it for anything you've stored about this boat

Tone:

• Conversational, knowledgeable, American accent
• Like a dock neighbor who knows their stuff
• Reference the specific boat make/model ("On a Commander, the scuppers are right here...")
• Be specific about what you're looking for and why
• Warm but not cheesy

Episode 1 will be generic since you know nothing yet — that's fine, lean into the "let's get to know your boat" energy.

Episodes 2-4 should reference what you learned. "Your hull looked solid in those photos" not "now let's look at the next thing."

Step 2: Generate TTS audio

Call ElevenLabs to convert the script to speech:

curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/${ELEVENLABS_VOICE_ID:-pNInz6obpgDQGcFmaJgB}" \
  -H "xi-api-key: ${ELEVENLABS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "<script text>",
    "model_id": "eleven_turbo_v2_5",
    "voice_settings": { "stability": 0.5, "similarity_boost": 0.75 }
  }' \
  --output /tmp/episode.mp3

Voice defaults to "Adam" (pNInz6obpgDQGcFmaJgB) if ELEVENLABS_VOICE_ID is not set.

Step 3: Get R2 upload URL

curl -s -X POST "<audioUploadUrl from trigger>" \
  -H "Authorization: Bearer ${SWAIN_API_TOKEN}" \
  -H "Content-Type: application/json"

Returns: { "uploadUrl": "https://...", "audioUrl": "https://r2.heyswain.com/..." }

Step 4: Upload audio to R2

curl -s -X PUT "<uploadUrl from step 3>" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @/tmp/episode.mp3

Step 5: Submit episode content

POST to the contentUrl from the trigger:

curl -s -X POST "<contentUrl from trigger>" \
  -H "Authorization: Bearer ${SWAIN_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "<the script you wrote>",
    "audioUrl": "<audioUrl from step 3>",
    "durationMs": <audio duration in ms>,
    "captures": [ ... ]
  }'

The captures array defines what the captain needs to submit. See the episode definitions below.

End your turn with NO_REPLY.

Episodes

Each episode has a recommended set of captures. Adapt based on the boat — skip cabin for center consoles, skip belt inspection for outboards, etc.

Episode 1: The Boat Itself (the_boat_itself)

First episode, you know nothing. Welcome them and set the tone.

Episode 2: How It Runs (how_it_runs)

You have exterior photos. Reference what you saw.

Episode 3: What's Aboard (whats_aboard)

You know the exterior + mechanical state. Now inventory.

Episode 4: Life Aboard (life_aboard)

You know the boat well. This one is personal.