file-sharing

This skill enables file exchange between you and the user through camelAI's chat interface.

User Uploads

Users can upload files by dragging and dropping onto the chat or clicking the + button. When they upload a file, you'll see a message like:

(user uploaded file to uploads/document-1736712345-abc123.pdf)

Uploads live in workspace-scoped R2. Use the normal file tools with location: "r2" and paths under uploads/.

Reading User Uploads

// List uploaded files
await tools.ls({ location: "r2", path: "uploads" });

// Read a specific text file
await tools.read({ location: "r2", path: "uploads/filename.txt" });

// Read an image; supported images are returned as image tool content
await tools.read({ location: "r2", path: "uploads/image.png" });

If you need a durable copy inside a project, copy it explicitly. For analysis, prefer reading the mounted upload directly at /uploads/<name> so large inputs are not duplicated:

await tools.move({
  source: { location: "r2", path: "uploads/input.csv" },
  destination: { location: "project", project: "analysis-app", path: "input.csv" },
});

Files persist across sessions, so users can reference previously uploaded files.

ZIP Archives

Do not pass an uploaded ZIP to the text read tool or extract it with an unchecked shell command. Inspect its manifest first, then read any scripts, Dockerfiles, dependency manifests, or other executable configuration directly from the archive:

await tools.inspect_archive({ path: "uploads/source.zip" });
await tools.inspect_archive({
  path: "uploads/source.zip",
  entry: "scripts/setup.sh",
});

After the archive and its executable/configuration entries are understood, use the purpose-built extractor. It rejects traversal paths, links, encrypted or special entries, ZIP bombs, and archives too large to persist safely:

await tools.extract_archive({
  path: "uploads/source.zip",
  project: "website",
  destination: ".",
});

Extraction writes into an existing project so the resulting files are durable and available to the normal project file and deployment tools.