Files
deepseek-harness/packages/util
mektpoy ef0eaa3167 docs(code-language): restate the read-hint contract in the summary
The Summary narrated the change ("the suffixes the old read table recognized keep their historical value") rather than the contract, and at 109 words it exceeded the 100-word package Summary limit.

State the rule a reader at HEAD can act on: a suffix a recorded session already holds keeps its persisted value, every other suffix takes its language's short name. The dropped path-separator and leading-dot detail stays documented under Language selection. Both languages updated and the pairing record re-recorded.
2026-09-23 14:53:58 +08:00
..
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00
2026-09-22 23:12:55 +08:00

description, kind
description kind
Package map for shared utilities: atomic file writes, branded ids, deques, JSON values, harness home paths, launch environment, native commands, output retention, time zones, and timeouts. package-group

util/ — shared utilities

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, outbound proxy policy, 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
package-manifest/ Shared TypeScript declarations for package manifests
crypto/ Mints RFC 9562 v4 UUIDs from the cross-runtime crypto.getRandomValues primitive
deque/ Provides amortized constant-time queue operations with bounded vacant storage
chunked-list/ Retains immutable list versions with bounded append copying and checkpoint validation
values/ Validates, snapshots, compares, and freezes lossless JSON-compatible values
home-paths/ Resolves the single Harness home and joins shared user-data paths
http-proxy/ Resolves one outbound proxy policy and installs it for fetch, SDK agents, and spawned children
launch-environment/ Frozen launch environment that remembers which layer supplied each value
atomic-write/ Atomic file replacement and cross-process writer locking
lazy-require/ Loads CommonJS-compatible Host dependencies on first use with caller-relative resolution
native-command/ Runs host-native commands directly, never through a shell string
workspace-path/ Provides browser-safe Workspace path and display helpers
code-language/ Maps a filename suffix to the syntax-highlighting language Code preview, diff review, and the read card render
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

Dev Note

Working context for maintainers — click to expand

None.