Files
CLIProxyAPI/internal/runtime/executor/helps/claude_code_user_agent.go

93 lines
2.9 KiB
Go

package helps
import "strings"
type claudeCodeUserAgent struct {
version claudeCLIVersion
entrypoint string
agentSDKVersion string
profileUserAgent string
requestFields []string
}
// parseClaudeCodeUserAgent separates client identity from opaque request fields.
// Parsing a valid UA does not establish native-client eligibility.
func parseClaudeCodeUserAgent(userAgent string) (claudeCodeUserAgent, bool) {
for _, char := range userAgent {
if (char < ' ' && char != '\t') || char == '\x7f' {
return claudeCodeUserAgent{}, false
}
}
userAgent = strings.TrimSpace(userAgent)
prefix, comment, ok := strings.Cut(userAgent, "(")
if !ok || !strings.HasSuffix(comment, ")") || prefix == strings.TrimSpace(prefix) {
return claudeCodeUserAgent{}, false
}
product := strings.TrimSpace(prefix)
versionText, okVersion := strings.CutPrefix(product, "claude-cli/")
if !okVersion || !claudePackageVersionPattern.MatchString(versionText) {
return claudeCodeUserAgent{}, false
}
version, okVersion := parseClaudeCLIVersion(product)
if !okVersion {
return claudeCodeUserAgent{}, false
}
comment = strings.TrimSuffix(comment, ")")
if strings.ContainsAny(comment, "()") {
return claudeCodeUserAgent{}, false
}
fields := strings.Split(comment, ",")
if len(fields) < 2 || !strings.EqualFold(fields[0], "external") {
return claudeCodeUserAgent{}, false
}
entrypoint := strings.ToLower(strings.TrimSpace(fields[1]))
if entrypoint == "" {
return claudeCodeUserAgent{}, false
}
parsed := claudeCodeUserAgent{
version: version, entrypoint: entrypoint, profileUserAgent: userAgent,
}
stableFields := []string{fields[0], fields[1]}
seen := make(map[string]struct{})
for _, field := range fields[2:] {
name, value, okField := strings.Cut(strings.TrimSpace(field), "/")
if !okField || !validClaudeCodeUserAgentFieldName(name) || strings.TrimSpace(value) == "" {
return claudeCodeUserAgent{}, false
}
name = strings.ToLower(name)
if _, duplicate := seen[name]; duplicate {
return claudeCodeUserAgent{}, false
}
seen[name] = struct{}{}
if name == "agent-sdk" {
if !claudePackageVersionPattern.MatchString(value) {
return claudeCodeUserAgent{}, false
}
parsed.agentSDKVersion = value
stableFields = append(stableFields, field)
} else {
parsed.requestFields = append(parsed.requestFields, field)
}
}
if len(parsed.requestFields) > 0 {
// Request fields must never become a credential's stored device identity.
parsed.profileUserAgent = prefix + "(" + strings.Join(stableFields, ",") + ")"
}
return parsed, true
}
func validClaudeCodeUserAgentFieldName(name string) bool {
if name == "" {
return false
}
// Extension names use HTTP token syntax; values remain opaque.
for _, char := range name {
if (char >= 'a' && char <= 'z') || (char >= 'A' && char <= 'Z') || (char >= '0' && char <= '9') ||
strings.ContainsRune("!#$%&'*+-.^_`|~", char) {
continue
}
return false
}
return true
}