vfs_agent

Overview ¶

Example: vfs_agent demonstrates the virtual filesystem for context offloading (WC-A-002). The agent produces a large intermediate artifact, saves it to per-session scratch storage with fs_write (paying only a tiny receipt in context instead of the whole artifact), keeps working with a small context, then pages part of it back in with fs_read to produce the final answer.

A deterministic mock model.Provider drives the loop, so the example runs with NO API keys and NO network access:

turn 0: generate a big report and fs_write it            (context stays tiny)
turn 1: fs_read the saved report back                    (page it in on demand)
turn 2: emit the final answer using the retrieved content

go run ./examples/vfs_agent/