@yagni-app/code-staging 0.3.0-staging.1080.1 → 0.3.0-staging.1081.1

package/dist/extension/config.d.ts

@@ -175,11 +175,23 @@ export declare function isDriverCaller(env?: NodeJS.ProcessEnv): boolean;
  * sanitizing client-side is what keeps the attribution instead of losing it.
  */
 export declare function sanitizeCallerSegment(name: string, maxLength?: number): string;
+/**
+ * Attribution headers for the boot-time /context fetch. Extends
+ * {@link attributionHeaders} (session id + caller) with the surface the
+ * session is painting for (the desktop driver sets YAGNI_SURFACE=desktop;
+ * the terminal CLI sets nothing) and the shipping client version. The server
+ * uses these to emit its "YAGNI Code Session Started" analytics event —
+ * labels only on that side: a missing or malformed value can never fail the
+ * fetch, it just goes uncounted or unversioned.
+ */
+export declare function sessionTelemetryHeaders(env?: NodeJS.ProcessEnv): Record<string, string>;
 /** Options for {@link fetchContextBrief}. */
 export interface FetchContextBriefOptions {
     baseUrl: string;
     getToken: () => string | undefined;
     fetchImpl?: typeof fetch;
+    /** Env seam for the telemetry headers; defaults to process.env. */
+    env?: NodeJS.ProcessEnv;
 }
 /**
  * Fetch the workspace company brief at startup.

package/dist/extension/config.js

@@ -177,6 +177,28 @@ export function sanitizeCallerSegment(name, maxLength = 64) {
     const trimmed = cleaned.slice(0, Math.max(0, maxLength));
     return trimmed || "agent";
 }
+/**
+ * Shape-check for a client version label (semver-ish; matches the server's
+ * own allowlist). A value that fails is dropped, never sent raw.
+ */
+const CLIENT_VERSION_RE = /^[0-9a-z][0-9a-z.+-]{0,31}$/i;
+/**
+ * Attribution headers for the boot-time /context fetch. Extends
+ * {@link attributionHeaders} (session id + caller) with the surface the
+ * session is painting for (the desktop driver sets YAGNI_SURFACE=desktop;
+ * the terminal CLI sets nothing) and the shipping client version. The server
+ * uses these to emit its "YAGNI Code Session Started" analytics event —
+ * labels only on that side: a missing or malformed value can never fail the
+ * fetch, it just goes uncounted or unversioned.
+ */
+export function sessionTelemetryHeaders(env = process.env) {
+    const headers = attributionHeaders(env);
+    headers["x-yagni-surface"] = env.YAGNI_SURFACE === "desktop" ? "desktop" : "cli";
+    const version = env.YAGNI_CODE_VERSION ?? "";
+    if (CLIENT_VERSION_RE.test(version))
+        headers["x-yagni-client-version"] = version;
+    return headers;
+}
 /**
  * Fetch the workspace company brief at startup.
  *
@@ -186,7 +208,13 @@ export function sanitizeCallerSegment(name, maxLength = 64) {
  */
 export async function fetchContextBrief(opts) {
     try {
-        const res = await resilientFetch(`${opts.baseUrl}/api/yagni-code/context`, { method: "GET", headers: { authorization: `Bearer ${opts.getToken() ?? ""}` } }, { fetchImpl: opts.fetchImpl });
+        const res = await resilientFetch(`${opts.baseUrl}/api/yagni-code/context`, {
+            method: "GET",
+            headers: {
+                authorization: `Bearer ${opts.getToken() ?? ""}`,
+                ...sessionTelemetryHeaders(opts.env),
+            },
+        }, { fetchImpl: opts.fetchImpl });
         if (!res.ok)
             return null;
         return (await res.json());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagni-app/code-staging",
-  "version": "0.3.0-staging.1080.1",
+  "version": "0.3.0-staging.1081.1",
   "description": "YAGNI Code: a terminal coding agent that already knows your company. One YAGNI login routes the model and grounds the agent in your team's context.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "YAGNI, Inc. <jack@yagni.app> (https://yagni.app)",
@@ -38,5 +38,5 @@
     "@earendil-works/pi-tui": "0.84.1",
     "typebox": "^1.3.11"
   },
-  "yagniSourceSha": "5227dca80cecdd4a84aac5c9af05328681fc5ca4"
+  "yagniSourceSha": "dd068fdb7b8bcb1207ff4f2fe803bf26b2e3eec3"
 }