{
    "message": "Analyze this configuration",
    "session_id": "session-1",
    "files": [{
        "name": "config.json",
        "mime_type": "application/json",
        "size": 1024,
        "content": "{ \"key\": \"value\" }"
    }]
}

{
    "message": "What does this image show?",
    "session_id": "session-1",
    "files": [{
        "name": "screenshot.png",
        "mime_type": "image/png",
        "size": 204800,
        "data": "iVBORw0KGgoAAAANS..."
    }]
}

curl -X POST http://localhost:3000/files/upload \
  -F "file=@./document.pdf"

const ref = await session.upload_file_to_storage(
    fs.readFileSync('./document.pdf'),
    'document.pdf',
    'application/pdf',
);
// ref.file_uri → file storage URI for use in messages

curl -X POST http://localhost:3000/files/upload-base64 \
  -H "Content-Type: application/json" \
  -d '{
    "data": "JVBERi0xLjQ...",
    "mime_type": "application/pdf",
    "name": "document.pdf"
  }'

{
    "message": "Summarize this insurance policy",
    "session_id": "session-1",
    "files": [{
        "name": "policy.pdf",
        "mime_type": "application/pdf",
        "size": 1048576,
        "file_uri": "https://generativelanguage.googleapis.com/v1beta/files/abc123"
    }]
}

const stream = session.send_with_files('Summarize this policy', [{
    name: 'policy.pdf',
    mime_type: 'application/pdf',
    size: 1048576,
    file_uri: ref.file_uri,
}]);

curl -X POST http://localhost:3000/upload \
  -F "file=@./data.csv" \
  -F "user_id=my-user" \
  -F "session_id=session-1"

const result = await session.upload_file(
    fs.readFileSync('./data.csv'),
    'data.csv',
    'text/csv',
);

{
    "success": true,
    "artifact_name": "data.csv",
    "mime_type": "text/csv",
    "size": 2048,
    "version": 0,
    "session_id": "session-1"
}