@poncho-ai/harness 0.59.8 → 0.59.9

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.59.8 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.59.9 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > node scripts/embed-docs.js && tsup src/index.ts --format esm --dts
 
 [embed-docs] Generated poncho-docs.ts with 4 topics
@@ -8,9 +8,9 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
+ESM dist/index.js            558.75 KB
 ESM dist/isolate-F2PPSUL6.js 53.82 KB
-ESM dist/index.js            558.23 KB
-ESM ⚡️ Build success in 235ms
+ESM ⚡️ Build success in 233ms
 DTS Build start
-DTS ⚡️ Build success in 8463ms
-DTS dist/index.d.ts 101.66 KB
+DTS ⚡️ Build success in 7974ms
+DTS dist/index.d.ts 102.06 KB

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @poncho-ai/harness
 
+## 0.59.9
+
+### Patch Changes
+
+- [`eb9600a`](https://github.com/cesr/poncho-ai/commit/eb9600a111cf74968689f8b33835d8b58c64e375) Thanks [@cesr](https://github.com/cesr)! - Root trace spans now carry `session.id` (= conversationId) and `user.id`
+  (new `config.telemetry.userId`) alongside the existing
+  `gen_ai.conversation.id` — the attributes observability backends
+  (Latitude) key session grouping and user filtering on.
+
 ## 0.59.8
 
 ### Patch Changes

package/dist/index.d.ts

@@ -756,6 +756,11 @@ interface PonchoConfig extends McpConfig {
             url: string;
             headers?: Record<string, string>;
         };
+        /** End-user identifier (e.g. an email) stamped as `user.id` on every
+         *  root trace span — observability backends (Latitude) group and
+         *  filter traces by it. Per-harness, so a harness-per-user consumer
+         *  sets it once at construction. */
+        userId?: string;
         handler?: (event: unknown) => Promise<void> | void;
     };
     skills?: Record<string, Record<string, unknown>>;
@@ -1442,6 +1447,8 @@ declare class AgentHarness {
     private otlpSpanProcessor?;
     private otlpTracerProvider?;
     private hasOtlpExporter;
+    /** End-user id (config.telemetry.userId) stamped as `user.id` on root spans. */
+    private telemetryUserId?;
     private _browserSession?;
     private _browserMod?;
     private parsedAgent?;

package/dist/index.js

@@ -9511,6 +9511,8 @@ var AgentHarness = class _AgentHarness {
   otlpSpanProcessor;
   otlpTracerProvider;
   hasOtlpExporter = false;
+  /** End-user id (config.telemetry.userId) stamped as `user.id` on root spans. */
+  telemetryUserId;
   _browserSession;
   _browserMod;
   parsedAgent;
@@ -10327,6 +10329,7 @@ var AgentHarness = class _AgentHarness {
     await this.refreshMcpTools("initialize");
     const telemetryEnabled = config?.telemetry?.enabled !== false;
     const otlpConfig = telemetryEnabled ? normalizeOtlp(config?.telemetry?.otlp) : void 0;
+    this.telemetryUserId = config?.telemetry?.userId;
     if (otlpConfig) {
       diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.WARN);
       const exporter = new OTLPTraceExporter({
@@ -10492,7 +10495,14 @@ var AgentHarness = class _AgentHarness {
         kind: SpanKind.INTERNAL,
         attributes: {
           "gen_ai.operation.name": "invoke_agent",
-          ...input.conversationId ? { "gen_ai.conversation.id": input.conversationId } : {},
+          // `session.id` / `user.id` are the attributes observability
+          // backends (Latitude) key session grouping and user filtering on.
+          // gen_ai.conversation.id is kept for the GenAI semantic convention.
+          ...input.conversationId ? {
+            "gen_ai.conversation.id": input.conversationId,
+            "session.id": input.conversationId
+          } : {},
+          ...this.telemetryUserId ? { "user.id": this.telemetryUserId } : {},
           ...input.tenantId ? { "tenant.id": input.tenantId } : {}
         }
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.59.8",
+  "version": "0.59.9",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",

package/src/config.ts

@@ -231,6 +231,11 @@ export interface PonchoConfig extends McpConfig {
       url: string;
       headers?: Record<string, string>;
     };
+    /** End-user identifier (e.g. an email) stamped as `user.id` on every
+     *  root trace span — observability backends (Latitude) group and
+     *  filter traces by it. Per-harness, so a harness-per-user consumer
+     *  sets it once at construction. */
+    userId?: string;
     handler?: (event: unknown) => Promise<void> | void;
   };
   skills?: Record<string, Record<string, unknown>>;

package/src/harness.ts

@@ -881,6 +881,8 @@ export class AgentHarness {
   private otlpSpanProcessor?: BatchSpanProcessor;
   private otlpTracerProvider?: NodeTracerProvider;
   private hasOtlpExporter = false;
+  /** End-user id (config.telemetry.userId) stamped as `user.id` on root spans. */
+  private telemetryUserId?: string;
   private _browserSession?: unknown;
   private _browserMod?: {
     createBrowserTools: (getSession: () => unknown, getConversationId?: () => string) => ToolDefinition[];
@@ -1871,6 +1873,7 @@ export class AgentHarness {
 
     const telemetryEnabled = config?.telemetry?.enabled !== false;
     const otlpConfig = telemetryEnabled ? normalizeOtlp(config?.telemetry?.otlp) : undefined;
+    this.telemetryUserId = config?.telemetry?.userId;
     if (otlpConfig) {
       diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.WARN);
       const exporter = new OTLPTraceExporter({
@@ -2057,7 +2060,16 @@ export class AgentHarness {
         kind: SpanKind.INTERNAL,
         attributes: {
           "gen_ai.operation.name": "invoke_agent",
-          ...(input.conversationId ? { "gen_ai.conversation.id": input.conversationId } : {}),
+          // `session.id` / `user.id` are the attributes observability
+          // backends (Latitude) key session grouping and user filtering on.
+          // gen_ai.conversation.id is kept for the GenAI semantic convention.
+          ...(input.conversationId
+            ? {
+                "gen_ai.conversation.id": input.conversationId,
+                "session.id": input.conversationId,
+              }
+            : {}),
+          ...(this.telemetryUserId ? { "user.id": this.telemetryUserId } : {}),
           ...(input.tenantId ? { "tenant.id": input.tenantId } : {}),
         },
       });