Files SDK 1.4 adds 9 storage adapters, an agent CLI, and optional peer deps
Files SDK 1.4 shipped nine new storage adapters, a CLI for agents, an installable skill, and optional peer dependencies. The update broadens storage coverage while sharply shrinking install weight, though adapter dependencies now need explicit installation.
TL;DR
- haydenbleasel's release thread says Files SDK 1.4 adds nine storage adapters, a new CLI for agents, an installable skill, and optional peer dependencies.
- According to haydenbleasel's follow-up, the peer-deps change cuts installed node_modules weight from 250 MB to 30 MB, but adapters now need an explicit install step.
- AlphaSignalAI's overview describes the project as a unified storage layer across 18 providers, with one API covering operations like upload, download, list, signedUploadUrl, and delete.
- AlphaSignalAI's thread also says the SDK ships ready-made tools for OpenAI, Vercel AI, and Claude Agent SDKs, which makes the new agent CLI and skill feel like an extension of an already agent-shaped project.
You can browse the project site, inspect the GitHub repo, and the small but meaningful buried detail is in haydenbleasel's install note: the package gets much lighter, but dependency handling gets more explicit. The other quiet change sits in his MDX follow-up, which says most of the site moved to MDX so new adapters are easier to contribute.
What shipped
Files SDK 1.4 is a straightforward breadth release. haydenbleasel's main post lists four changes:
- 9 new storage adapters
- new CLI for agents
- installable skill
- optional peer dependencies
The release lands on top of a project that AlphaSignalAI's overview says already exposes one API across 18 storage providers, including S3, R2, Vercel Blob, and Google Drive. That same post says the common surface includes upload, download, head, delete, copy, list, url, and signedUploadUrl.
Agent tooling
The new CLI and installable skill push the SDK further into agent tooling. AlphaSignalAI's description says Files SDK already ships ready-made tools for OpenAI, Vercel AI, and Claude Agent SDKs, plus approval-gating defaults for browsing and mutating buckets.
That gives the 1.4 release a clear shape: storage abstraction on one side, agent-facing packaging on the other. The new CLI matters less as a standalone binary than as another surface for the same storage actions.
Optional peer dependencies
The sharpest concrete number in the release is the install footprint. According to haydenbleasel's follow-up, optional peer dependencies drop node_modules impact from 250 MB to 30 MB.
The tradeoff is also in that same post: adapter packages now need to be installed explicitly. the follow-up adds one more packaging change, you no longer need to ship .raw because the dependency can be used directly.
MDX docs
The final release note is about contribution flow, not runtime behavior. haydenbleasel's MDX post says most of the site has been migrated to MDX so new adapters are easier to contribute.
For a library whose 1.4 headline is adapter expansion, that docs change is part of the release story. The public surface is getting wider, and the path to adding the next adapter is getting lighter too.