util/
September 4, 2026 · View on GitHub
English | 中文
Summary
The util/ group gives capability packages shared mechanical primitives instead of duplicate implementations. It covers atomic writes, branded ids, deques, lossless JSON values, UUIDs, Harness-home paths, launch environments, native commands, output retention, time-zone canonicalization, and timeout handling. Every root entry here is a library: it registers no product service or event, and the consuming capability retains the business semantics.
Table of Contents
Packages
Each package provides one primitive; open a package page for how to use it.
| Package | Role |
|---|---|
brand/ | Nominal string types and their stateless constructor |
crypto/ | Mints RFC 9562 v4 UUIDs from the cross-runtime crypto.getRandomValues primitive |
deque/ | Provides amortized constant-time queue operations with bounded vacant storage |
values/ | Validates, snapshots, compares, and freezes lossless JSON-compatible values |
home-paths/ | Resolves the single Harness home and joins shared user-data paths |
launch-environment/ | Frozen launch environment that remembers which layer supplied each value |
atomic-write/ | Atomic file replacement and cross-process writer locking |
native-command/ | Runs host-native commands directly, never through a shell string |
workspace-path/ | Provides browser-safe Workspace path and display helpers |
output-retention/ | Bounds model-facing output and reports exact omission metadata |
time/ | Validates and canonicalizes a caller-reported IANA time zone |
timeout/ | Deadline arithmetic, signal fusion, and timeout-versus-cancel classification |
Related documentation
- Root package map — where
util/sits among all package groups. - Generated configuration catalog — the library-package index this group forms part of.
- Adding a package cookbook — how a new shared primitive lands in this group.
Dev Note
Working context for maintainers — click to expand
None.