mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
28 lines
1.3 KiB
TypeScript
28 lines
1.3 KiB
TypeScript
/**
|
|
* The `Branded<B>` nominal-typing primitive — a type-only utility (no runtime
|
|
* code, no harness-package dependency) shared by every package that owns a
|
|
* cross-boundary id.
|
|
*
|
|
* A brand makes structurally-identical strings non-interchangeable at the type
|
|
* level: a `SessionId` cannot be passed where a `CallId` is expected, even
|
|
* though both are plain strings at runtime. Construction goes through a per-id
|
|
* factory in the OWNING package (a plain cast inside — zero runtime cost);
|
|
* comparison, logging, and serialization all behave as ordinary strings.
|
|
*
|
|
* Policy: a package brands the ids it owns — `CallId` in dsh-llm (tool-call
|
|
* correlation), and `SessionId` in dsh-session; `BashTaskId`/`OwnerToken` live
|
|
* in dsh-bash. Branding is for ids that cross package boundaries and could
|
|
* plausibly be confused; not every string needs a brand.
|
|
* This package owns ONLY the primitive — no concrete id, no runtime code beyond
|
|
* the (erased) type — so the brand vocabulary stays dependency-free and a
|
|
* package can brand its ids without depending on an unrelated capability
|
|
* package (e.g. dsh-bash brands its ids without pulling in dsh-llm).
|
|
*
|
|
* @module @deepseek-ai/dsh-brand
|
|
*/
|
|
|
|
declare const BRAND: unique symbol
|
|
|
|
/** A string carrying a compile-time-only brand `B`. */
|
|
export type Branded<B extends string> = string & { readonly [BRAND]: B }
|