@yagni-app/code 1.0.8 → 1.0.9

package/README.md

@@ -208,9 +208,13 @@ prefix instead of `claude_code`:
 
 Every signal carries `organization.id` (the workspace) and `user.email` (the
 signed-in developer's account email, learned from the backend at session
-start) so a collector can attribute sessions and spend per person.
-`OTEL_METRICS_INCLUDE_ACCOUNT_UUID=false` drops the email from all three
-signals. Prompt, response, and tool content never export.
+start) so a collector can attribute sessions and spend per person. The LLM
+span additionally declares `user.email` as a Datadog cost tag (the
+`_dd.ml_obs.metadata` attribute, `{"_dd":{"cost_tags":["user.email"]}}`), so
+Datadog's LLM Observability Cost page offers it under Custom Tags → Group by
+and breaks spend down per developer. `OTEL_METRICS_INCLUDE_ACCOUNT_UUID=false`
+drops the email, and that declaration, from all three signals. Prompt,
+response, and tool content never export.
 
 Nothing is exported unless you configure an endpoint. Enable it one of three
 ways (first match wins):

package/dist/extension/telemetry/attrs.d.ts

@@ -56,6 +56,13 @@ export declare const ATTR_GEN_AI_CACHE_CREATION_TOKENS_LEGACY = "gen_ai.usage.ca
  * Unit is NANODOLLARS (integer), not dollars: Datadog copies the value
  * unscaled into its nanodollar cost metric. */
 export declare const ATTR_GEN_AI_COST_ESTIMATED_TOTAL = "gen_ai.cost.estimated_total";
+/** Datadog's OTLP escape hatch: a JSON-object string merged into the LLM
+ * Observability span's `meta.metadata`. Its `_dd.cost_tags` list is where
+ * Datadog's own SDKs declare which span tags the Cost page may group spend
+ * by (the SDK-only `cost_tags` parameter); sending the same shape here is
+ * what makes `user.email` a Group-by option on the vendor Cost page.
+ * Verified against live probe spans on 2026-09-04. */
+export declare const ATTR_DD_LLMOBS_METADATA = "_dd.ml_obs.metadata";
 export declare const ATTR_GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
 export declare const ATTR_GEN_AI_AGENT_NAME = "gen_ai.agent.name";
 export declare const ATTR_GEN_AI_TOOL_NAME = "gen_ai.tool.name";

package/dist/extension/telemetry/attrs.js

@@ -58,6 +58,13 @@ export const ATTR_GEN_AI_CACHE_CREATION_TOKENS_LEGACY = "gen_ai.usage.cache_crea
  * Unit is NANODOLLARS (integer), not dollars: Datadog copies the value
  * unscaled into its nanodollar cost metric. */
 export const ATTR_GEN_AI_COST_ESTIMATED_TOTAL = "gen_ai.cost.estimated_total";
+/** Datadog's OTLP escape hatch: a JSON-object string merged into the LLM
+ * Observability span's `meta.metadata`. Its `_dd.cost_tags` list is where
+ * Datadog's own SDKs declare which span tags the Cost page may group spend
+ * by (the SDK-only `cost_tags` parameter); sending the same shape here is
+ * what makes `user.email` a Group-by option on the vendor Cost page.
+ * Verified against live probe spans on 2026-09-04. */
+export const ATTR_DD_LLMOBS_METADATA = "_dd.ml_obs.metadata";
 export const ATTR_GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
 export const ATTR_GEN_AI_AGENT_NAME = "gen_ai.agent.name";
 export const ATTR_GEN_AI_TOOL_NAME = "gen_ai.tool.name";

package/dist/extension/telemetry/tracker.js

@@ -20,7 +20,7 @@
 import { randomUUID } from "node:crypto";
 import { context as otelContext, SpanStatusCode, trace, } from "@opentelemetry/api";
 import { SeverityNumber } from "@opentelemetry/api-logs";
-import { ATTR_APP_ENTRYPOINT, ATTR_APP_VERSION, ATTR_ERROR_TYPE, ATTR_GEN_AI_AGENT_NAME, ATTR_GEN_AI_CACHE_CREATION_TOKENS_LEGACY, ATTR_GEN_AI_CACHE_READ_TOKENS, ATTR_GEN_AI_CACHE_READ_TOKENS_LEGACY, ATTR_GEN_AI_CACHE_WRITE_TOKENS, ATTR_GEN_AI_CONVERSATION_ID, ATTR_GEN_AI_COST_ESTIMATED_TOTAL, ATTR_GEN_AI_FINISH_REASONS, ATTR_GEN_AI_INPUT_TOKENS, ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_OUTPUT_TOKENS, ATTR_GEN_AI_TOTAL_TOKENS, ATTR_GEN_AI_PROVIDER_NAME, ATTR_GEN_AI_REQUEST_MODEL, ATTR_GEN_AI_RESPONSE_ID, ATTR_GEN_AI_RESPONSE_MODEL, ATTR_GEN_AI_SYSTEM, ATTR_GEN_AI_TOOL_CALL_ID, ATTR_GEN_AI_TOOL_NAME, ATTR_GEN_AI_TOOL_TYPE, ATTR_HTTP_STATUS_CODE, ATTR_ORGANIZATION_ID, ATTR_SESSION_ID, ATTR_TERMINAL_TYPE, ATTR_USER_EMAIL, EVENT_API_ERROR, EVENT_API_REQUEST, EVENT_ASSISTANT_RESPONSE, EVENT_PERMISSION_MODE_CHANGED, EVENT_TOOL_DECISION, EVENT_TOOL_RESULT, EVENT_USER_PROMPT, GEN_AI_PROVIDER, languageFromPath, METRIC_ACTIVE_TIME, METRIC_CODE_EDIT_DECISION, METRIC_COMMIT_COUNT, METRIC_COST_USAGE, METRIC_LINES_OF_CODE, METRIC_PULL_REQUEST_COUNT, METRIC_SESSION_COUNT, METRIC_TOKEN_USAGE, PREFIX, SPAN_INTERACTION, SPAN_LLM_REQUEST, SPAN_TOOL, SPAN_TURN, } from "./attrs.js";
+import { ATTR_APP_ENTRYPOINT, ATTR_APP_VERSION, ATTR_ERROR_TYPE, ATTR_GEN_AI_AGENT_NAME, ATTR_GEN_AI_CACHE_CREATION_TOKENS_LEGACY, ATTR_GEN_AI_CACHE_READ_TOKENS, ATTR_GEN_AI_CACHE_READ_TOKENS_LEGACY, ATTR_GEN_AI_CACHE_WRITE_TOKENS, ATTR_DD_LLMOBS_METADATA, ATTR_GEN_AI_CONVERSATION_ID, ATTR_GEN_AI_COST_ESTIMATED_TOTAL, ATTR_GEN_AI_FINISH_REASONS, ATTR_GEN_AI_INPUT_TOKENS, ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_OUTPUT_TOKENS, ATTR_GEN_AI_TOTAL_TOKENS, ATTR_GEN_AI_PROVIDER_NAME, ATTR_GEN_AI_REQUEST_MODEL, ATTR_GEN_AI_RESPONSE_ID, ATTR_GEN_AI_RESPONSE_MODEL, ATTR_GEN_AI_SYSTEM, ATTR_GEN_AI_TOOL_CALL_ID, ATTR_GEN_AI_TOOL_NAME, ATTR_GEN_AI_TOOL_TYPE, ATTR_HTTP_STATUS_CODE, ATTR_ORGANIZATION_ID, ATTR_SESSION_ID, ATTR_TERMINAL_TYPE, ATTR_USER_EMAIL, EVENT_API_ERROR, EVENT_API_REQUEST, EVENT_ASSISTANT_RESPONSE, EVENT_PERMISSION_MODE_CHANGED, EVENT_TOOL_DECISION, EVENT_TOOL_RESULT, EVENT_USER_PROMPT, GEN_AI_PROVIDER, languageFromPath, METRIC_ACTIVE_TIME, METRIC_CODE_EDIT_DECISION, METRIC_COMMIT_COUNT, METRIC_COST_USAGE, METRIC_LINES_OF_CODE, METRIC_PULL_REQUEST_COUNT, METRIC_SESSION_COUNT, METRIC_TOKEN_USAGE, PREFIX, SPAN_INTERACTION, SPAN_LLM_REQUEST, SPAN_TOOL, SPAN_TURN, } from "./attrs.js";
 /** Idle cutoff for user active time: gaps longer than this are not "active". */
 export const USER_ACTIVE_IDLE_CUTOFF_MS = 5 * 60 * 1000;
 const EDIT_TOOLS = new Set(["edit", "write", "multi_edit", "notebook_edit"]);
@@ -238,6 +238,13 @@ export class SessionTelemetry {
             attrs[ATTR_GEN_AI_REQUEST_MODEL] = model;
             attrs.model = model;
         }
+        // Declare `user.email` as a cost-breakdown tag for Datadog's Cost page.
+        // Only when the tag is actually on the span (same account gate): Datadog
+        // skips entries that reference a missing tag, but an empty declaration
+        // is noise. Bounded cardinality by construction: one value per seat.
+        if (ATTR_USER_EMAIL in attrs) {
+            attrs[ATTR_DD_LLMOBS_METADATA] = JSON.stringify({ _dd: { cost_tags: [ATTR_USER_EMAIL] } });
+        }
         const span = this.tracer.startSpan(SPAN_LLM_REQUEST, { attributes: attrs }, parent);
         this.llm = {
             span,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagni-app/code",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "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)",
@@ -58,5 +58,5 @@
     "turndown": "^7.2.4",
     "typebox": "^1.3.15"
   },
-  "yagniSourceSha": "9b213ea65690a4544d0cdf093b6903aab8a1456b"
+  "yagniSourceSha": "fbd1d838bd6701d0e8135e415210ca1974bc4269"
 }