forked from sanbuphy/learn-coding-agent
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathids.ts
More file actions
44 lines (38 loc) · 1.26 KB
/
ids.ts
File metadata and controls
44 lines (38 loc) · 1.26 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
/**
* Branded types for session and agent IDs.
* These prevent accidentally mixing up session IDs and agent IDs at compile time.
*/
/**
* A session ID uniquely identifies a Claude Code session.
* Returned by getSessionId().
*/
export type SessionId = string & { readonly __brand: 'SessionId' }
/**
* An agent ID uniquely identifies a subagent within a session.
* Returned by createAgentId().
* When present, indicates the context is a subagent (not the main session).
*/
export type AgentId = string & { readonly __brand: 'AgentId' }
/**
* Cast a raw string to SessionId.
* Use sparingly - prefer getSessionId() when possible.
*/
export function asSessionId(id: string): SessionId {
return id as SessionId
}
/**
* Cast a raw string to AgentId.
* Use sparingly - prefer createAgentId() when possible.
*/
export function asAgentId(id: string): AgentId {
return id as AgentId
}
const AGENT_ID_PATTERN = /^a(?:.+-)?[0-9a-f]{16}$/
/**
* Validate and brand a string as AgentId.
* Matches the format produced by createAgentId(): `a` + optional `<label>-` + 16 hex chars.
* Returns null if the string doesn't match (e.g. teammate names, team-addressing).
*/
export function toAgentId(s: string): AgentId | null {
return AGENT_ID_PATTERN.test(s) ? (s as AgentId) : null
}