@barry-rocks/sdk/ids

Shared identifier types and helpers: harness, mode, model, and vendor ids, parseModelRef and modelRef for vendor/model strings, isHarnessId, and generateId.

import { … } from "@barry-rocks/sdk/ids";

API

Type Aliases

HarnessId

HarnessId = string

---

JsonSchema

JsonSchema = Record<string, unknown>

Plain JSON Schema rather than a zod type: the workspace is split across zod 3 and zod 4, and accepting either would force every contract to pick a side.

---

ModeId

ModeId = "hosted" | "instrumented" | "guest"

Who is at the controls of a session, and so what Barry holds.

---

ModelKind

ModelKind = "completion" | "embedding" | "decision"

---

ModelRef

ModelRef = `${VendorId}/${string}`

A model as its vendor names it: ollama/qwen3:4b, anthropic/claude-opus-5.

---

VendorId

VendorId = string

Variables

HARNESS_ID_MAX_LENGTH

const HARNESS_ID_MAX_LENGTH: 64 = 64

---

HARNESS_ID_PATTERN

const HARNESS_ID_PATTERN: RegExp

What a harness id may look like — shape, not membership. Ids reach directory names and CLI flags, so one that could not be either is wrong before anyone asks whether that harness is installed; whether it IS is the installed-adapters record’s answer.

A RegExp rather than a zod schema because the workspace is split across zod 3 and zod 4, and both need it.

---

HarnessIdSchema

const HarnessIdSchema: ZodString

A validated harness id — SHAPE, not membership.

Was a closed enum of the four Barry ships, which made a third-party adapter impossible to record. Whether a harness is installed is answered where installation is recorded (~/.barry/adapters.json, and the agent_adapters foreign key beneath session rows); this answers whether an id could be one at all.

---

MODE_IDS

const MODE_IDS: readonly ModeId[]

Functions

generateId()

generateId(): string

A new opaque id: 21 URL-safe characters, as nanoid makes them, from Web Crypto so it runs anywhere.

Returns

string

---

isHarnessId()

isHarnessId(id): boolean

Parameters

Parameter	Type
id	string

Returns

boolean

---

modelRef()

modelRef(vendor, model): `${string}/${string}`

Parameters

Parameter	Type
vendor	string
model	string

Returns

`${string}/${string}`

---

parseModelRef()

parseModelRef(ref): { model: string; vendor: string; } | undefined

Split a ref at its FIRST slash. Model ids may contain slashes themselves — an Ollama model pulled from Hugging Face is hf.co/org/name — so the vendor is everything before the first one and the model is everything after.

Parameters

Parameter	Type
ref	string

Returns

{ model: string; vendor: string; } | undefined