Files SDK

Files SDK provides a unified software development kit that enables developers to interact with a wide range of object and blob storage providers through a single, consistent API. The platform is designed to let users write code once and use it across multiple backends, including S3, R2, GCS, Azure, Vercel Blob, Netlify Blobs, MinIO, and others. This approach addresses the challenge of integrating with different storage services by abstracting their interfaces under one API, simplifying code maintenance and portability.

The SDK supports a comprehensive set of file operations such as upload, download, head (metadata retrieval), list, delete, copy, move, and existence checks. These operations are available uniformly across all supported adapters, allowing developers to switch storage backends without changing their application logic. Batch processing is supported by passing arrays to methods, enabling operations like deleting multiple files with bounded concurrency. Listings can be traversed as asynchronous iterables, and the SDK includes features like multipart uploads, live progress tracking, byte range support, and lifecycle hooks.

Advanced search capabilities are included, with the ability to find files by name using glob patterns, regular expressions, substrings, or exact matches. The search function streams results as asynchronous iterables and supports scoping searches by prefix to improve efficiency. The SDK also offers ready-made file tools for integration with AI agent frameworks such as the Vercel AI SDK, OpenAI Agents, Claude, and MCP. These tools allow agents to list, read, upload, and delete files, with options for read-only mode and per-tool approval gates.

Files SDK is available as a JavaScript package installable via npm, and every method is also accessible from the command line interface. The tool is positioned as a unified SDK for object and blob storage providers, streamlining storage integration for developers working across diverse platforms.