28 lines
888 B
TypeScript
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
|
|
}
|