Skip to content

dokan v0.2.0 — run artifacts: input files (beta/preview)

Pre-release
Pre-release

Choose a tag to compare

@helios-code helios-code released this 25 Jun 23:29
· 22 commits to main since this release
fece2ae

dokan v0.2.0 — run artifacts: input files (beta / preview)

Feed a job real local documents — a PDF, a dataset, a .md — without stuffing them into DOKAN_INPUT.

What's new

  • upload_blob(data, filename?) → handle — content-addressed blob store (blake3); re-uploading identical bytes dedups to one row. 32 MiB per blob. download_blob(handle) fetches bytes back.
  • run_script files={"<name>": "<handle>"} — materializes each file read-only at /input/<name> in the container.
  • Blob shas fold into the run's receipt (and cache key), so a job reading /input stays a pure function of its declared inputs — determinism, cache, and a portable receipt are preserved, where a host bind-mount would break all three.

Why upload, not host-mount

Snapshot the bytes into the run; the agent on the host attaches the doc, the container never pierces its wall. The convergent pattern of E2B / Modal / OpenAI Code Interpreter, kept hermetic à la Bazel/Nix. Design: docs/specs/v0.2.0-run-artifacts.md.

No-files runs are byte-identical to before. Output artifacts (/output capture) land in a follow-up. Still honest beta/preview — see SECURITY.md.