Implement lazy file reference system

[adrianlyjak]

Introduce a file reference system to manage large remote files in durable workflows, enabling lazy hydration, caching, and cleanup.

---

Linear Issue: LI-4463

 

[changeset-bot]

⚠️ No Changeset found

Latest commit: 0fa945e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coveralls]

Pull Request Test Coverage Report for Build 19514409812

Details

• 60 of 171 (35.09%) changed or added relevant lines in 2 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage decreased (-0.7%) to 86.478%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
packages/llama-index-workflows/src/workflows/file_ref.py	59	170	34.71%

Totals
Change from base Build 19478552248:	-0.7%
Covered Lines:	8928
Relevant Lines:	10324

---

💛 - Coveralls