1.9 KiB
1.9 KiB
ADR-0049: gzip compression resource operations
Status: Accepted
Date: 2026-11-21
Relates to: ADR-0041
Specs: spec/evaluation.md
Evidence: docs/evidence/2026-11-21-compress-product.md
Context
Compression is pure computation, but implementing gzip in .mq.md would either
duplicate a large algorithm or under-deliver. Adding a new Rust builtin would
expand the language surface; the existing non-streaming resource.request
channel is a better fit for an explicitly bounded codec operation.
Decision
Add two project-mode operations:
resource.request("compress.gzip", [text]) -> {ok:true, value:List<Int>}
resource.request("compress.gunzip", [bytes]) -> {ok:true, value:Text}
| {ok:false, code:"compress.invalid"}
| {ok:false, code:"compress.not_utf8"}
| {ok:false, code:"compress.too_large"}
gziptakes Text, caps input at 8 MiB, writes a deterministic gzip header (no filename/time) and returns a byte list.gunziptakes aList<Int>of bytes, caps input and output at 8 MiB, returns Text on success, and maps bad gzip/UTF-8/oversize output to the recoverable codes above.- No new capability flag is added: compression is deterministic CPU work and
does not disclose external state. It remains project-mode only because all
resource.requestoperations do;pure/strictrefuse it. flate2(miniz_oxide backend) is the implementation. No new builtin,HostOp, parser node or wire value is added.stdlib/compress.mq.mdexposes压缩/解压.
Consequences
- Callers can compress data without a second language surface, but must pass
byte lists through ordinary
List<Int>values. - Streaming gzip, raw deflate, zstd/brotli and binary
Memoryoutput remain open. A streaming codec would need a new Resource kind.