deepseek-harness/packages/util/README.md

description, kind

description	kind
Package map for the zero-dependency utility family: atomic file writes, branded ids, harness home paths, the launch environment, native commands, output retention, and timeouts.	package-group

util/ — zero-dependency shared utilities

English | 中文

Summary

The util/ group gives capability packages shared mechanical primitives instead of duplicate implementations. It covers atomic writes, branded ids, UUIDs, Harness-home paths, launch environments, native commands, output retention, and timeout handling. Every package here is a library: it registers no service or event, and the consuming capability retains the business semantics.

Table of Contents

• Packages
• Related documentation
• Dev Note

---

Packages

Each package provides one primitive; open a package page for how to use it.

Package	Role
brand/	Compile-time-only nominal brands for ids that cross package boundaries
crypto/	Mints RFC 9562 v4 UUIDs from the cross-runtime crypto.getRandomValues primitive
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
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.