Files
orcs-code/src/utils/uuid.ts
did:key:z6MkqDnb7Siv3Cwj7pGJq4T5EsUisECqR8KpnDLwcaZq5TPr d2542c9a62 asdf
Squash the current repository state back into one baseline commit while
preserving the README reframing and repository contents.

Constraint: User explicitly requested a single squashed commit with subject "asdf"
Confidence: high
Scope-risk: broad
Reversibility: clean
Directive: This commit intentionally rewrites published history; coordinate before future force-pushes
Tested: git status clean; local history rewritten to one commit; force-pushed main to origin and instructkr
Not-tested: Fresh clone verification after push
2026-03-31 03:34:03 -07:00

28 lines
888 B
TypeScript

import { randomBytes, type UUID } from 'crypto'
import type { AgentId } from 'src/types/ids.js'
const uuidRegex =
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
/**
* Validate uuid
* @param maybeUUID The value to be checked if it is a uuid
* @returns string as UUID or null if it is not valid
*/
export function validateUuid(maybeUuid: unknown): UUID | null {
// UUID format: 8-4-4-4-12 hex digits
if (typeof maybeUuid !== 'string') return null
return uuidRegex.test(maybeUuid) ? (maybeUuid as UUID) : null
}
/**
* Generate a new agent ID with prefix for consistency with task IDs.
* Format: a{label-}{16 hex chars}
* Example: aa3f2c1b4d5e6f7a8, acompact-a3f2c1b4d5e6f7a8
*/
export function createAgentId(label?: string): AgentId {
const suffix = randomBytes(8).toString('hex')
return (label ? `a${label}-${suffix}` : `a${suffix}`) as AgentId
}