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

src/utils/uuid.ts

@@ -0,0 +1,27 @@
+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
+}