deepseek-harness/packages/util
2026-06-22 01:38:39 +08:00
..
brand fix: apply ts-build-config adjustment to new packages 2026-06-22 01:38:39 +08:00
README.md fix review findings: document the util/ group + align branded-ids RFC with dsh-brand 2026-06-21 11:04:28 +08:00

util/ — low-level shared utilities

Zero-dependency primitives shared across the other groups. A package lands here when it owns a tiny, foundational type or helper that several capability families need but that belongs to none of them — keeping it out of any one group avoids a capability package depending on an unrelated one just to reach a shared primitive. These are support packages: small, stable, and free of harness dependencies.

Package Role
brand/ The type-only Branded<B> nominal-typing primitive (no runtime code, no harness deps)

dsh-brand is the canonical case: it owns ONLY the Branded<B> helper, so a capability package can brand the ids it owns (dsh-bash's BashTaskId/OwnerToken, dsh-session's SessionId, …) by depending on dsh-brand alone, without pulling in an unrelated package just to reach Branded.