@poncho-ai/harness 0.59.9 → 0.59.10

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.59.9 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.59.10 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 ⚡️ Build success in 233ms
+ESM dist/index.js            559.89 KB
+ESM ⚡️ Build success in 238ms
 DTS Build start
-DTS ⚡️ Build success in 7974ms
+DTS ⚡️ Build success in 7368ms
 DTS dist/index.d.ts 102.06 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @poncho-ai/harness
 
+## 0.59.10
+
+### Patch Changes
+
+- [`fad3918`](https://github.com/cesr/poncho-ai/commit/fad3918302114f76a29080cf28e9c003c61ef0d9) Thanks [@cesr](https://github.com/cesr)! - Stamp `session.id` / `user.id` on EVERY span, not just the invoke_agent
+  root. Observability backends resolve a span's identity from its own
+  attributes — Latitude's console session/conversation views key on the LLM
+  generation spans, so root-only attributes grouped the API-level trace but
+  left the console showing one session per turn and no user. The identity now
+  rides the OTel Context and an IdentityAttributeSpanProcessor injects it
+  into every descendant span (LLM steps, tool executions) at start.
+
 ## 0.59.9
 
 ### Patch Changes

package/dist/index.js

@@ -8745,7 +8745,7 @@ var createSubagentTools = (manager) => [
 ];
 
 // src/harness.ts
-import { trace, context as otelContext, SpanStatusCode, SpanKind, diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import { trace, context as otelContext, createContextKey, SpanStatusCode, SpanKind, diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
 import { NodeTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 
@@ -8928,6 +8928,28 @@ var telemetryLog2 = createLogger7("telemetry");
 var costLog = createLogger7("cost");
 var mcpLog2 = createLogger7("mcp");
 var modelLog = createLogger7("model");
+var TELEMETRY_SESSION_ID_KEY = createContextKey("poncho.telemetry.session_id");
+var TELEMETRY_USER_ID_KEY = createContextKey("poncho.telemetry.user_id");
+var IdentityAttributeSpanProcessor = class {
+  onStart(span, parentContext) {
+    const sessionId = parentContext.getValue(TELEMETRY_SESSION_ID_KEY);
+    if (typeof sessionId === "string" && sessionId) {
+      span.setAttribute("session.id", sessionId);
+    }
+    const userId = parentContext.getValue(TELEMETRY_USER_ID_KEY);
+    if (typeof userId === "string" && userId) {
+      span.setAttribute("user.id", userId);
+    }
+  }
+  onEnd() {
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+};
 function formatOtlpError(err) {
   if (!(err instanceof Error)) return String(err);
   const parts = [];
@@ -10339,7 +10361,9 @@ var AgentHarness = class _AgentHarness {
       const processor = new BatchSpanProcessor(exporter);
       this.otlpSpanProcessor = processor;
       const provider2 = new NodeTracerProvider({
-        spanProcessors: [processor]
+        // Identity injector FIRST so every span (root, LLM steps, tool
+        // executions) carries session.id/user.id before batching/export.
+        spanProcessors: [new IdentityAttributeSpanProcessor(), processor]
       });
       provider2.register();
       this.otlpTracerProvider = provider2;
@@ -10506,7 +10530,13 @@ var AgentHarness = class _AgentHarness {
           ...input.tenantId ? { "tenant.id": input.tenantId } : {}
         }
       });
-      const spanContext = trace.setSpan(otelContext.active(), rootSpan);
+      let spanContext = trace.setSpan(otelContext.active(), rootSpan);
+      if (input.conversationId) {
+        spanContext = spanContext.setValue(TELEMETRY_SESSION_ID_KEY, input.conversationId);
+      }
+      if (this.telemetryUserId) {
+        spanContext = spanContext.setValue(TELEMETRY_USER_ID_KEY, this.telemetryUserId);
+      }
       try {
         const gen = this.run(input);
         let next;

package/package.json

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

package/src/harness.ts

@@ -67,9 +67,41 @@ import { createSkillTools, normalizeScriptPolicyPath } from "./skill-tools.js";
 import { createSearchTools } from "./search-tools.js";
 import { createSubagentTools } from "./subagent-tools.js";
 import type { SubagentManager } from "./subagent-manager.js";
-import { trace, context as otelContext, SpanStatusCode, SpanKind, diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import { trace, context as otelContext, createContextKey, type Context as OtelContextType, SpanStatusCode, SpanKind, diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import type { Span as OtelSdkSpan, SpanProcessor } from "@opentelemetry/sdk-trace-node";
 import { NodeTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+
+// ── Telemetry identity propagation ──────────────────────────────────────────
+// Observability backends (Latitude) resolve a span's session/user from the
+// span's OWN attributes — the console's session & conversation views key on
+// the LLM generation spans, not the root span. So stamping `session.id` /
+// `user.id` only on the invoke_agent root groups the API-level trace but
+// leaves the console treating every turn as its own session. The fix is the
+// same one vendor SDKs use: carry the identity in the OTel Context and have
+// a SpanProcessor stamp it onto EVERY span at start.
+const TELEMETRY_SESSION_ID_KEY = createContextKey("poncho.telemetry.session_id");
+const TELEMETRY_USER_ID_KEY = createContextKey("poncho.telemetry.user_id");
+
+class IdentityAttributeSpanProcessor implements SpanProcessor {
+  onStart(span: OtelSdkSpan, parentContext: OtelContextType): void {
+    const sessionId = parentContext.getValue(TELEMETRY_SESSION_ID_KEY);
+    if (typeof sessionId === "string" && sessionId) {
+      span.setAttribute("session.id", sessionId);
+    }
+    const userId = parentContext.getValue(TELEMETRY_USER_ID_KEY);
+    if (typeof userId === "string" && userId) {
+      span.setAttribute("user.id", userId);
+    }
+  }
+  onEnd(): void {}
+  forceFlush(): Promise<void> {
+    return Promise.resolve();
+  }
+  shutdown(): Promise<void> {
+    return Promise.resolve();
+  }
+}
 import { normalizeOtlp } from "./telemetry.js";
 
 /** Extract useful details from OTLPExporterError (has .code + .data) or plain Error. */
@@ -1883,7 +1915,9 @@ export class AgentHarness {
       const processor = new BatchSpanProcessor(exporter);
       this.otlpSpanProcessor = processor;
       const provider = new NodeTracerProvider({
-        spanProcessors: [processor],
+        // Identity injector FIRST so every span (root, LLM steps, tool
+        // executions) carries session.id/user.id before batching/export.
+        spanProcessors: [new IdentityAttributeSpanProcessor(), processor],
       });
       provider.register();
       this.otlpTracerProvider = provider;
@@ -2074,7 +2108,15 @@ export class AgentHarness {
         },
       });
 
-      const spanContext = trace.setSpan(otelContext.active(), rootSpan);
+      let spanContext = trace.setSpan(otelContext.active(), rootSpan);
+      // Identity rides the context so IdentityAttributeSpanProcessor stamps
+      // session.id/user.id on every descendant span (see processor docs).
+      if (input.conversationId) {
+        spanContext = spanContext.setValue(TELEMETRY_SESSION_ID_KEY, input.conversationId);
+      }
+      if (this.telemetryUserId) {
+        spanContext = spanContext.setValue(TELEMETRY_USER_ID_KEY, this.telemetryUserId);
+      }
 
       try {
         const gen = this.run(input);