cartethyia 2.7.4 → 2.7.5

package/src/providers/integrations/buddy/buddy-chat-shared.ts

@@ -168,10 +168,11 @@ export function normalizeBuddyToolNames(payload: Record<string, unknown>): void
  * Both realms have a "let the backend choose" id, and the reference rewrites
  * `auto` onto it before anything downstream keys on the name — so eligibility,
  * cooldowns and the catalog all see one id. CN's is `default`; intl's is
- * `default-model`.
+ * `default-model` (confirmed from live CLI session logs, which send
+ * `model=default-model` for the intl auto path).
  */
 const BUDDY_AUTO_TARGET: Readonly<Record<"intl" | "cn", string>> = {
-  intl: "auto",
+  intl: "default-model",
   cn: "default",
 };
 
@@ -348,8 +349,8 @@ const DSH_MINIMAL_PATTERN = buddyTemplatePattern("You are a helpful software eng
 const DSH_DIRECT_PATTERN = buddyTemplatePattern("You are DeepSeek Harness");
 const DSH_WEB_GUI_PATTERN = buddyTemplatePattern("DeepSeek Harness Web GUI");
 
-/** The identity DSH role prompts are rewritten to; matches the donor gateway. */
-const DSH_WORKBUDDY_IDENTITY = "You are WorkBuddy, a powerful AI assistant";
+/** The identity DSH role prompts are rewritten to; neutral and minimal. */
+const DSH_WORKBUDDY_IDENTITY = "You are a helpful assistant";
 
 /**
  * Rewrites DeepSeek Harness role identities in one message's text back to the
@@ -425,6 +426,20 @@ export const clineReasoningReplayPrepares: readonly ((
   },
 ];
 
+/**
+ * The reference injects `cache_retention` on every chat body: `long` by
+ * default, `short` when prompt caching for 1h is disabled
+ * (`CODEBUDDY_DISABLE_PROMPT_CACHING_1H`). Matching the client keeps the
+ * upstream's prompt-caching behavior and price on the same path the CLI uses.
+ */
+function injectBuddyCacheRetention(payload: Record<string, unknown>): void {
+  if (payload["cache_retention"] !== undefined) return;
+  const disabled =
+    process.env.CODEBUDDY_DISABLE_PROMPT_CACHING_1H?.trim() === "1" ||
+    process.env.CODEBUDDY_DISABLE_PROMPT_CACHING_1H?.trim().toLowerCase() === "true";
+  payload["cache_retention"] = disabled ? "short" : "long";
+}
+
 /**
  * Payload prefix shared by the buddy pre-payload hooks: force `stream=true`,
  * apply the provider's DeepSeek thinking contract, opt `reasoning_summary` in
@@ -437,6 +452,7 @@ export function buddyPrePayloadCommon(
   context?: ProviderDispatchContext,
 ): void {
   injectBuddyPromptCacheKey(payload, request, context);
+  injectBuddyCacheRetention(payload);
   // `auto` and `default-model` are the same upstream model under two names, and
   // the reference resolves one to the other everywhere — catalog, eligibility,
   // cooldown keys. Treating them as two independent rows meant a client that

package/src/providers/integrations/buddy/buddy-cli-headers.ts

@@ -3,51 +3,19 @@
  *
  * Everything here comes from the two reference gateways, which agree: the
  * desktop product sends conversation/tracing headers and a device token, while
- * the CLI sends the agent envelope plus the OpenAI Node SDK fingerprint. The
- * CLI still drops the browser *transport* headers (`origin`, `referer`,
- * `accept-language`) and the device token, but keeps the request-shape markers
- * (`x-requested-with`, `x-codebuddy-request`) the reference sends on every call
- * regardless of transport — see the CLI branches in each provider's
- * `*-shared.ts`.
+ * the CLI sends the agent envelope. The CLI still drops the browser *transport*
+ * headers (`origin`, `referer`, `accept-language`) and the device token, but
+ * keeps the request-shape markers (`x-requested-with`, `x-codebuddy-request`)
+ * the reference sends on every call regardless of transport — see the CLI
+ * branches in each provider's `*-shared.ts`.
  *
- * The SDK fingerprint is pinned, not host-derived. Both references pin a fixed
- * set (codebuddy2api pins Linux/x64/v24.21.0); this gateway pins the macOS set
- * instead, so every CLI dispatch presents one consistent client fingerprint no
- * matter which machine the gateway runs on. A host-derived fingerprint would
- * advertise whatever OS the process happens to run under — a value no upstream
- * risk model has seen for this client brand, and an easy outlier to key on.
+ * The CLI's cloud chat transport is axios (`RestOperations`), not the OpenAI
+ * Node SDK, so it sends **no** `x-stainless-*` fingerprint. The reference's
+ * chat request helper sets only `Content-Type`, `Accept`, and `Authorization`
+ * before the conversation/agent/identity headers are injected; the stainless
+ * set belongs to the SDK-backed secondary clients, not to CodeBuddy chat.
  */
 
-/** OpenAI Node SDK 6.25.0 `x-stainless-*` fingerprint; both references agree. */
-const STAINLESS_PACKAGE_VERSION = "6.25.0";
-
-/**
- * The pinned Node runtime the fingerprint claims. Held constant across
- * dispatches: a drifting `process.version` would advertise a different Node
- * build per deployment, which is not what one installed client looks like.
- */
-const STAINLESS_RUNTIME_VERSION = "v24.21.0";
-
-/**
- * The SDK fingerprint headers.
- *
- * `x-stainless-timeout` is in the hub only and `x-stainless-retry-count` is in
- * both; the SDK sends both, so both go out. The OS/arch pair is the pinned
- * macOS fingerprint rather than this process's host.
- */
-export function buddyStainlessHeaders(): Record<string, string> {
-  return {
-    "x-stainless-lang": "js",
-    "x-stainless-package-version": STAINLESS_PACKAGE_VERSION,
-    "x-stainless-os": "MacOS",
-    "x-stainless-arch": "x64",
-    "x-stainless-runtime": "node",
-    "x-stainless-runtime-version": STAINLESS_RUNTIME_VERSION,
-    "x-stainless-retry-count": "0",
-    "x-stainless-timeout": "1200",
-  };
-}
-
 /**
  * The trace family the CLI carries as a child span.
  *
@@ -69,13 +37,18 @@ export function buddyCliTraceHeaders(
 /**
  * The full CLI identity envelope, minus what each caller already supplies.
  *
- * The caller keeps ownership of `User-Agent`, `X-IDE-*`, `X-Domain`, and the
- * conversation family, because those vary by provider and realm: only the
- * headers that are the same for every CLI dispatch are built here.
+ * The caller keeps ownership of `User-Agent`, `X-IDE-*`, `X-Domain`, the
+ * conversation family, and the OAuth identity headers; only the headers that
+ * are the same for every CLI dispatch are built here.
+ *
+ * No `x-stainless-*` fingerprint: the CLI's chat transport is axios, not the
+ * OpenAI Node SDK. `X-Private-Data` is added by the caller only when the
+ * dispatch is actually private — the reference never sends it as `false`.
  */
 export function buddyCliHeaders(args: {
   readonly userId: string;
   readonly enterpriseId?: string | undefined;
+  readonly privateData?: boolean;
 }): Record<string, string> {
   const enterpriseId =
     args.enterpriseId !== undefined && args.enterpriseId.trim().length > 0
@@ -89,12 +62,7 @@ export function buddyCliHeaders(args: {
     // of the three, so "other" is the honest value rather than a guess.
     "X-Agent-Runtime": "other",
     "X-User-Id": args.userId,
-    // The reference sends the flag either way, `true` only for an enterprise
-    // id. A personal account stays `false`; an enterprise account flips to
-    // `true` and names the enterprise, because the two travel together — a
-    // `true` with no id, or an id under `false`, is a combination no real
-    // client produces.
-    "X-Private-Data": enterpriseId === undefined ? "false" : "true",
+    ...(args.privateData === true ? { "X-Private-Data": "true" } : {}),
     ...(enterpriseId === undefined
       ? {}
       : {
@@ -104,6 +72,5 @@ export function buddyCliHeaders(args: {
           // reads both.
           "X-Tenant-Id": enterpriseId,
         }),
-    ...buddyStainlessHeaders(),
   };
 }

package/src/providers/integrations/buddy/buddy-identity.ts

@@ -1,6 +1,8 @@
 import type { ProviderDispatchContext } from "../../provider-contracts";
 import { createHash } from "node:crypto";
 import { decodeJwtPayload } from "../../authentication/oauth-flow-store";
+import { buddyAccountUid } from "./buddy-oauth-shared";
+import type { CanonicalRequest } from "../../../protocol/canonical-model";
 
 /**
  * Which upstream client a buddy provider presents itself as.
@@ -41,8 +43,17 @@ export function resolveBuddyIdentity(
  * The reference CLI sends the literal `anonymous` when it has no uid rather
  * than omitting the header, so an unauthenticated dispatch still looks like a
  * client rather than like a caller that forgot a header.
+ *
+ * When the credential carries a JWT, the `sub` claim is the upstream uid and
+ * wins over the gateway's internal account id — the two can differ after an
+ * import, and the channel check keys on the upstream identity. Opaque API keys
+ * carry no identity, so the internal account id is the fallback.
  */
 export function buddyUserId(context?: ProviderDispatchContext): string {
+  const secret = context?.credential?.secret;
+  const token = secret ? new TextDecoder().decode(secret).trim() : "";
+  const uid = buddyAccountUid(token);
+  if (uid !== undefined) return uid;
   const accountId = context?.credential.account_id;
   return accountId !== undefined && accountId.length > 0 ? accountId : "anonymous";
 }
@@ -142,3 +153,78 @@ export function materializeBuddyDeviceBinding(
   const derived = createHash("sha256").update(`wb2a:qimei36:${accountId}`).digest("hex").slice(0, 32);
   return { ...(authState ?? {}), qimei36: derived };
 }
+
+/**
+ * The OAuth identity header family the reference ships on every cloud API call
+ * (`runIdentityHeaders`): `X-User-Id` plus the base64 `X-Userinfo` envelope and
+ * the auth-method / id-source markers.
+ *
+ * The JWT `sub` is the uid; the base64 envelope mirrors the reference exactly:
+ * `{ uin, owner_uin?, id_source?, token_source? }` — one leg per identity
+ * field that exists, so a personal account sends `{uin}` while an enterprise
+ * account adds `owner_uin`. `X-Auth-Method` / `X-Id-Source` are only sent when
+ * the operator pinned them in `auth_state` (there is no reliable source to
+ * invent them from). An opaque API key carries no uid and yields nothing.
+ */
+export function buddyOAuthIdentityHeaders(
+  context?: ProviderDispatchContext,
+): Record<string, string> {
+  const secret = context?.credential?.secret;
+  const token = secret ? new TextDecoder().decode(secret).trim() : "";
+  const uid = buddyAccountUid(token) ?? context?.credential.account_id ?? "";
+  if (uid.length === 0) return {};
+  const enterpriseId = buddyEnterprise(context);
+  const state = context?.credential.auth_state;
+  const idSource =
+    typeof state?.["idSource"] === "string" && (state["idSource"] as string).trim().length > 0
+      ? (state["idSource"] as string).trim()
+      : undefined;
+  const method =
+    typeof state?.["authMethod"] === "string" && (state["authMethod"] as string).trim().length > 0
+      ? (state["authMethod"] as string).trim()
+      : undefined;
+  const headers: Record<string, string> = { "X-User-Id": uid };
+  if (method !== undefined) headers["X-Auth-Method"] = method;
+  if (idSource !== undefined) headers["X-Id-Source"] = idSource;
+  if (enterpriseId !== undefined || idSource !== undefined || method !== undefined) {
+    const info: Record<string, string> = { uin: uid };
+    if (enterpriseId !== undefined) info["owner_uin"] = enterpriseId;
+    if (idSource !== undefined) info["id_source"] = idSource;
+    if (method !== undefined) info["token_source"] = method;
+    headers["X-Userinfo"] = Buffer.from(JSON.stringify(info), "utf-8").toString("base64");
+  }
+  return headers;
+}
+
+/**
+ * Whether this dispatch is in the reference's private-data mode. The CLI only
+ * sends `X-Private-Data: true` while the session is private; otherwise the
+ * header is deleted, never sent as `false`. The gateway has no session-level
+ * private flag, so the operator pins one per account in `auth_state.privateData`.
+ */
+export function buddyPrivateData(context?: ProviderDispatchContext): boolean {
+  return context?.credential.auth_state?.["privateData"] === true;
+}
+
+/**
+ * The effective agent purpose for one dispatch, matching the reference's
+ * `getEffectiveAgentPurpose` behavior as closely as the gateway can:
+ *
+ * - `PERSONAL_AGENT_ROLE` set → `person_agent` (same env the CLI reads);
+ * - otherwise an inbound `x-agent-purpose` header is preserved (the caller
+ *   already stated a purpose — same shape the reference passes through);
+ * - otherwise the header is omitted. The reference does not invent `conversation`.
+ */
+export function buddyAgentPurpose(
+  context?: ProviderDispatchContext,
+  request?: CanonicalRequest,
+): string | undefined {
+  if (process.env.PERSONAL_AGENT_ROLE && process.env.PERSONAL_AGENT_ROLE.trim().length > 0) {
+    return "person_agent";
+  }
+  const inbound = context?.request_headers?.["x-agent-purpose"]?.trim();
+  if (inbound !== undefined && inbound.length > 0) return inbound;
+  const fromRequest = request?.metadata?.["agent_purpose"];
+  if (typeof fromRequest === "string" && fromRequest.trim().length > 0) return fromRequest.trim();
+  return undefined;
+}

package/src/providers/integrations/buddy/buddy-oauth-shared.ts

@@ -120,7 +120,7 @@ export function buddyAccountUid(accessToken: string): string | undefined {
  * Falls back to `undefined` when the token carries no usable identity, letting
  * the console keep the operator-supplied label.
  */
-export function buddyAccountLabel(accessToken: string): string | undefined {
+function buddyAccountLabel(accessToken: string): string | undefined {
   const claims = decodeJwtPayload(accessToken);
   if (!claims) return undefined;
   const email = nonEmptyTrimmedString(claims.email) ?? nonEmptyTrimmedString(claims.preferred_username);

package/src/providers/integrations/buddy/codebuddy/cn-provider.ts

@@ -48,8 +48,7 @@ function isAgentPromptText(text: string): boolean {
   );
 }
 
-const CODEBUDDY_CN_NEUTRAL_PROMPT =
-  "You are a helpful AI assistant that helps with software engineering tasks.";
+const CODEBUDDY_CN_NEUTRAL_PROMPT = "You are a helpful assistant.";
 
 function flattenContent(content: unknown): string {
   if (typeof content === "string") return content;

package/src/providers/integrations/buddy/codebuddy/provider.ts

@@ -51,22 +51,11 @@ export const CODEBUDDY_BASE_URL = providerBaseUrl("cb");
  *
  * The wire contract is that the request *opens* with a `system` turn (code
  * `11128`); the gateway replaces any caller `system`/`developer` turn with this
- * fixed prompt. The text is the CodeBuddy CLI's own leading prompt — the same
- * one the reference client (and the donor gateway's `prepend` prompt mode)
- * sends — so a proxied request is byte-faithful to an official client rather
- * than a neutral stand-in.
- *
- * Keeping the official identity is forward-compatible: the upstream is not
- * observed to validate this text today, but a proxy that claims the real
- * client's identity cannot be caught out if it starts to. A previous neutral
- * persona ("You are a pragmatic and direct software engineering assistant…")
- * worked, but diverged from every request the official CLI emits.
+ * fixed prompt. Deliberately neutral: a simple helpful-assistant persona with
+ * no client/CLI branding, kept minimal so the text reads naturally to any
+ * model and does not advertise a channel identity upstream.
  */
-export const CODEBUDDY_SYSTEM_PROMPT =
-  "You are CodeBuddy Code.\n\n" +
-  "You are an interactive CLI tool that helps users with software engineering tasks. " +
-  "Use the instructions below and the tools available to you to assist the user. " +
-  "Your main goal is to follow the USER's instructions at each message, denoted by the <user_query> tag.";
+export const CODEBUDDY_SYSTEM_PROMPT = "You are a helpful assistant.";
 
 function codeBuddyIntlPrePayload(
   payload: Record<string, unknown>,

package/src/providers/integrations/buddy/codebuddy/shared.ts

@@ -3,7 +3,15 @@ import type { CanonicalRequest } from "../../../../protocol/canonical-model";
 import type { ProviderDispatchContext, ProviderDispatchTarget, ProviderId } from "../../../provider-contracts";
 import { resolveInboundSessionId } from "../../../operations/session-resolution";
 import { buddyConversationHeaders } from "../buddy-conversation-headers";
-import { buddyEnterprise, buddyUserId, resolveBuddyDeviceBinding, resolveBuddyIdentity } from "../buddy-identity";
+import {
+  buddyAgentPurpose,
+  buddyEnterprise,
+  buddyOAuthIdentityHeaders,
+  buddyPrivateData,
+  buddyUserId,
+  resolveBuddyDeviceBinding,
+  resolveBuddyIdentity,
+} from "../buddy-identity";
 import { buildCodeBuddyUserAgent, getCodeBuddyCnVersion, getCodeBuddyVersion } from "../../../operations/client-versions";
 import { buddyDeviceTokenHeaders } from "../workbuddy/shared";
 import { CODEBUDDY_TURING_CONFIG } from "../turing-device-token";
@@ -40,6 +48,13 @@ export async function codebuddyHeaders(
     ...(conversationId === undefined ? {} : { conversationId }),
   });
   if (resolveBuddyIdentity(context, cliIdentity) === "cli") {
+    const purpose = buddyAgentPurpose(context, request);
+    // Root/parent conversation context is forwarded only when the caller
+    // actually supplied it — the reference emits these conditionally for
+    // subagent/root chains and never invents them.
+    const inbound = context?.request_headers;
+    const rootRequestId = inbound?.["x-root-request-id"]?.trim();
+    const parentConversationId = inbound?.["x-parent-conversation-id"]?.trim();
     return {
       // The CLI sends `Accept: application/json` and no device token. It keeps
       // the request-shape markers (`X-Requested-With`, `X-CodeBuddy-Request`)
@@ -55,19 +70,24 @@ export async function codebuddyHeaders(
       "X-Domain": codebuddyDomain(variant),
       "x-requested-with": "XMLHttpRequest",
       "x-codebuddy-request": "1",
-      // The conversation purpose the reference client states. Not required —
-      // verified against the live API that a request succeeds without it — but
-      // it is part of the client's real request, and matching the client is the
-      // defence against a channel check tightening later.
-      "X-Agent-Purpose": "conversation",
+      ...(purpose === undefined ? {} : { "X-Agent-Purpose": purpose }),
       ...conversation,
+      ...(rootRequestId === undefined ? {} : { "X-Root-Request-ID": rootRequestId }),
+      ...(parentConversationId === undefined
+        ? {}
+        : { "X-Parent-Conversation-ID": parentConversationId }),
       ...buddyCliTraceHeaders(conversation),
+      // The CLI's OAuth identity family: X-User-Id from the JWT sub plus the
+      // base64 X-Userinfo envelope when identity fields exist.
+      ...buddyOAuthIdentityHeaders(context),
       ...buddyCliHeaders({
         userId: buddyUserId(context),
         enterpriseId: buddyEnterprise(context),
+        privateData: buddyPrivateData(context),
       }),
     };
   }
+  const purpose = buddyAgentPurpose(context, request);
   return {
     accept: "text/event-stream",
     "User-Agent": ua,
@@ -81,9 +101,10 @@ export async function codebuddyHeaders(
     "X-Domain": codebuddyDomain(variant),
     "x-requested-with": "XMLHttpRequest",
     "x-codebuddy-request": "1",
-    // Same value the CLI branch sends, for the same reason: part of the
-    // client's real request, harmless when the channel check does not read it.
-    "X-Agent-Purpose": "conversation",
+    // The effective agent purpose, matching the reference's dynamic value.
+    // The reference does not invent `conversation`; it sends the purpose only
+    // when one exists.
+    ...(purpose === undefined ? {} : { "X-Agent-Purpose": purpose }),
     // Same family WorkBuddy sends: the upstream's channel check reads the
     // turn-level aggregation key, and a chat request without it is refused for a
     // missing conversation id.

package/src/providers/integrations/buddy/workbuddy/provider.ts

@@ -56,15 +56,11 @@ export const WORKBUDDY_BASE_URL = providerBaseUrl("workbuddy");
  * channel"`. So this prompt is a wire contract, not merely a product choice —
  * see the sibling in `codebuddy.ts`.
  *
- * The text is WorkBuddy's own leading prompt, matching what the official client
- * (and the donor gateway's `prepend` prompt mode) sends, so a proxied request
- * carries the real client's identity instead of a neutral stand-in. A previous
- * neutral persona was accepted but diverged from every request the official
- * desktop client emits.
+ * The text is deliberately neutral: a simple helpful-assistant persona with no
+ * client/CLI branding, kept minimal so it reads naturally to any model and
+ * does not advertise a channel identity upstream.
  */
-export const WORKBUDDY_SYSTEM_PROMPT =
-  "You are WorkBuddy, a powerful AI assistant.\n\n" +
-  "Your main goal is to follow the USER's instructions at each message, denoted by the <user_query> tag.";
+export const WORKBUDDY_SYSTEM_PROMPT = "You are a helpful assistant.";
 
 /**
  * Reconstructs generic function declarations when a later tool-history turn
@@ -156,7 +152,7 @@ export function workbuddyPrePayload(
 // declared reasoning-effort scale.
 const WORKBUDDY_RAW: readonly BuddyRawEntry[] = BUDDY_SHARED_RAW;
 
-export function makeWorkBuddyModels(providerId: "workbuddy" | "workbuddycn"): readonly ModelDefinition[] {
+function makeWorkBuddyModels(providerId: "workbuddy" | "workbuddycn"): readonly ModelDefinition[] {
   return [
     ...WORKBUDDY_RAW.filter(
       (entry) => !BUDDY_IMAGE_MODEL_ID_SET.has(entry[0]) && !BUDDY_VIDEO_MODEL_ID_SET.has(entry[0]),

package/src/providers/integrations/buddy/workbuddy/shared.ts

@@ -8,7 +8,15 @@ import type { ProviderDispatchContext, ProviderDispatchTarget, ProviderId } from
 import { resolveInboundSessionId } from "../../../operations/session-resolution";
 import { buddyConversationHeaders } from "../buddy-conversation-headers";
 import { buddyCliHeaders, buddyCliTraceHeaders } from "../buddy-cli-headers";
-import { buddyEnterprise, buddyUserId, resolveBuddyDeviceBinding, resolveBuddyIdentity } from "../buddy-identity";
+import {
+  buddyAgentPurpose,
+  buddyEnterprise,
+  buddyOAuthIdentityHeaders,
+  buddyPrivateData,
+  buddyUserId,
+  resolveBuddyDeviceBinding,
+  resolveBuddyIdentity,
+} from "../buddy-identity";
 import {
   buildWorkBuddyUserAgent,
   getWorkBuddyClientVersion,
@@ -86,7 +94,11 @@ export async function workbuddyHeaders(
     messageIdStyle: identity === "desktop" ? "uuid" : "hex",
   });
   const accountId = context?.credential.account_id;
+  const purpose = buddyAgentPurpose(context, request);
   if (identity === "cli") {
+    const inbound = context?.request_headers;
+    const rootRequestId = inbound?.["x-root-request-id"]?.trim();
+    const parentConversationId = inbound?.["x-parent-conversation-id"]?.trim();
     // The reference CLI: issued by the OpenAI Node SDK, so no browser
     // *transport* header (origin/referer/accept-language) and no device token,
     // and the machine/session device pair does not exist — only `X-User-Id`,
@@ -99,17 +111,23 @@ export async function workbuddyHeaders(
       "x-requested-with": "XMLHttpRequest",
       "x-codebuddy-request": "1",
       "x-domain": domain,
-      "x-agent-purpose": "conversation",
+      ...(purpose === undefined ? {} : { "x-agent-purpose": purpose }),
       "x-ide-name": "CLI",
       "x-ide-type": "CLI",
       "x-ide-version": getWorkBuddyCliVersion(),
       "x-product": "SaaS",
       "x-no-enterprise-id": "1",
       ...conversation,
+      ...(rootRequestId === undefined ? {} : { "x-root-request-id": rootRequestId }),
+      ...(parentConversationId === undefined
+        ? {}
+        : { "x-parent-conversation-id": parentConversationId }),
       ...buddyCliTraceHeaders(conversation),
+      ...buddyOAuthIdentityHeaders(context),
       ...buddyCliHeaders({
         userId: buddyUserId(context),
         enterpriseId: buddyEnterprise(context),
+        privateData: buddyPrivateData(context),
       }),
     };
   }
@@ -122,7 +140,7 @@ export async function workbuddyHeaders(
     "x-requested-with": "XMLHttpRequest",
     "x-codebuddy-request": "1",
     "x-domain": domain,
-    "x-agent-purpose": "conversation",
+    ...(purpose === undefined ? {} : { "x-agent-purpose": purpose }),
     "x-ide-name": "WorkBuddy",
     "x-ide-type": "WorkBuddy",
     "x-ide-version": clientVersion,