agentleFS
Sign inStart free
CloudflareKnown publishercloudflare/workerd/src/bench/streams/readable-byte/AGENTS.md

workerd / readable-byte

AGENTS.md9.1k starsChanged 8 months agoApache-2.0View on GitHub

ReadableStream with type: 'bytes', under both implementations. Suite rules: src/bench/streams/AGENTS.md. The byte shapes are 256 x 64 B, 64 x 4 KiB and 16 x 64 KiB (SHAPES in helpers.js): many small chunks, a common network read size, and large chunks. - For a default read of a byte stream without autoAllocateChunkSize, C++ allocates a 4 KiB BYOB request (16 KiB under an autogate) where the TypeScript implementation, like the spec, has none (readable-byte test ledger #5). defaultReader's pull() source…

Create a free account to mount
Files
AGENTS.md

Readable byte stream benchmarks

ReadableStream with type: 'bytes', under both implementations. Suite rules: src/bench/streams/AGENTS.md.

The byte shapes are 256 x 64 B, 64 x 4 KiB and 16 x 64 KiB (SHAPES in helpers.js): many small chunks, a common network read size, and large chunks.

Module map

ModuleGroupCases
construction.jsconstruction16 constructions per call: plain; with autoAllocateChunkSize; then getReader({ mode: 'byob' })
default-reader.jsdefaultReaderDefault reads of each shape: chunks enqueued in start(), or one per pull()
byob-reader.jsbyobReaderBYOB reads of each shape, reusing the returned buffer: the source filling the views with respond(), and reads copying from enqueued chunks; read(view, { min }) and readAtLeast() needing four respond()s per read; and 16 reads per call from long-lived streams, by view size
auto-allocate.jsautoAllocateDefault reads of each shape with autoAllocateChunkSize, the source filling the allocated views
tee.jsteeBoth branches of each shape read

Comparing

  • For a default read of a byte stream without autoAllocateChunkSize, C++ allocates a 4 KiB BYOB request (16 KiB under an autogate) where the TypeScript implementation, like the spec, has none (readable-byte test ledger #5). defaultReader's pull() source enqueues regardless, which both accept, so under C++ each pull also allocates a request that the enqueue discards.
  • The respond() sources are used only for reads that have a BYOB request under both implementations: BYOB reads, and default reads with autoAllocateChunkSize.

Download now (ZIP)

Trending

More talk lately.about the whole repository

Dec 2025: 0 mentionsJan 2026: 3 mentionsFeb 2026: 0 mentionsMar 2026: 2 mentionsApr 2026: 3 mentionsMay 2026: 0 mentionsJun 2026: 0 mentionsJul 2026: 0 mentionsAug 2026: 7 mentionsSep 2026: 5 mentionsOct 2026: 4 mentionsNov 2026: 0 mentions
Dec 2025Jun 2026Nov 2026
Mentions a month of the cloudflare/workerd repository that our weekly crawl found. There is no adoption data for this file yet.

Who's talking about cloudflare/workerd

The biggest 5 of 40 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 40

Talked about on GitHub, Bluesky, Hacker News and Stack Overflow (40 times).

On GitHub · 33

28 more on GitHub

On Hacker News · 2

On Stack Overflow · 1

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free