// Shared User-Agent for xAI sidecar HTTP/WS requests; mirrors `formatOpenClawUserAgent`. import { OPENCLAW_VERSION as PACKAGE_VERSION } from "openclaw/plugin-sdk/agent-harness-runtime"; import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime"; const ORIGINATOR = "openclaw"; const UNUSABLE_PACKAGE_VERSION = "0.0.0"; const FALLBACK_VERSION = "unknown"; function resolveXaiUserAgentVersion(): string { // Env-first matches resolveRuntimeServiceVersion. const envVersion = normalizeOptionalString(process.env.OPENCLAW_VERSION); if (envVersion) { return envVersion; } const packageVersion = normalizeOptionalString(PACKAGE_VERSION); if (packageVersion && packageVersion !== UNUSABLE_PACKAGE_VERSION) { return packageVersion; } return normalizeOptionalString(process.env.npm_package_version) ?? FALLBACK_VERSION; } export function xaiUserAgent(): string { return `${ORIGINATOR}/${resolveXaiUserAgentVersion()}`; } const XAI_NATIVE_API_HOSTS = new Set(["api.x.ai"]); // Returns a `User-Agent` header entry only when the resolved baseUrl points // at a verified xAI-native API host. User-configured proxy baseUrls produce // an empty record so the openclaw identity is not forwarded to the proxy. export function xaiUserAgentHeaderFor(baseUrl: string | undefined): Record { if (!baseUrl) { return {}; } try { if (XAI_NATIVE_API_HOSTS.has(new URL(baseUrl).hostname)) { return { "User-Agent": xaiUserAgent() }; } } catch { return {}; } return {}; }