Fix CLI document add command: send form data instead of URL parameters

[Copilot]

Problem

The CLI command extralit documents add --workspace <workspace> --reference <ref> --file <file> was failing with the error "Server disconnected without sending a response." This prevented users from adding individual documents via the CLI.

Root Cause

The issue was a mismatch between how the client sends document metadata and how the server expects to receive it:

• Client: The DocumentsAPI.create() method was sending document metadata as URL parameters (params=document_payload)
• Server: The /api/v1/documents endpoint expects document metadata as form fields via FastAPI's Depends() mechanism

When uploading files with multipart form data, this parameter/form data mismatch caused the server to fail parsing the request, resulting in a dropped connection.

Solution

Modified DocumentsAPI.create() in extralit/src/extralit/_api/_documents.py to send document metadata in the correct format:

• File uploads: Send metadata as form data (data=document_payload) with multipart files - compatible with FastAPI Depends()
• Non-file uploads: Send metadata as JSON (json=document_payload) - also compatible with FastAPI
• Removed: URL parameters (params=document_payload) which were incompatible

# Before (broken)
response = self.http_client.post(url=url, params=document_payload, files=files)

# After (fixed) 
response = self.http_client.post(url=url, data=document_payload, files=files)

Testing

Verified the fix works correctly for both scenarios:

• ✅ File uploads now send metadata as form fields with multipart files
• ✅ URL-only documents send metadata as JSON
• ✅ No URL parameters are used (which were causing the compatibility issue)

The CLI command extralit documents add --workspace priyankesh-test --reference paper-001 --file ./paper.pdf should now work as expected.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.