@poncho-ai/harness 0.59.7 → 0.59.9

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.59.7 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.06 KB
-ESM ⚡️ Build success in 257ms
+ESM ⚡️ Build success in 233ms
 DTS Build start
-DTS ⚡️ Build success in 7680ms
-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,25 @@
 # @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
+
+- [`fb07954`](https://github.com/cesr/poncho-ai/commit/fb07954ee7edfa614bdd5ed27474f4d3be7c8f1f) Thanks [@cesr](https://github.com/cesr)! - Fix conversations.rename on Postgres: the JSONB `data` column usually
+  holds a JSON-encoded string scalar (update() binds JSON.stringify output),
+  so the 0.59.3 in-blob title update threw `cannot set path in scalar` and
+  every rename 500'd. The UPDATE now branches on jsonb_typeof(data) and
+  preserves each row's encoding (objects via jsonb_set; string scalars
+  unwrapped, set, and re-serialized).
+
 ## 0.59.7
 
 ### 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

@@ -3918,7 +3918,10 @@ var SqlStorageEngine = class {
     },
     rename: async (conversationId, title) => {
       const normalized = normalizeTitle2(title);
-      const dataExpr = this.dialect.tag === "sqlite" ? `json_set(data, '$.title', $2)` : `jsonb_set(data, '{title}', to_jsonb($2::text))`;
+      const dataExpr = this.dialect.tag === "sqlite" ? `json_set(data, '$.title', $2)` : `CASE WHEN jsonb_typeof(data) = 'object'
+             THEN jsonb_set(data, '{title}', to_jsonb($2::text))
+             ELSE to_jsonb(jsonb_set((data #>> '{}')::jsonb, '{title}', to_jsonb($2::text))::text)
+           END`;
       await this.executor.run(
         rewrite(
           `UPDATE conversations SET title = $1, data = ${dataExpr}, updated_at = $3 WHERE id = $4`,
@@ -9508,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;
@@ -10324,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({
@@ -10489,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.7",
+  "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 } : {}),
         },
       });

package/src/storage/sql-dialect.ts

@@ -571,9 +571,21 @@ export abstract class SqlStorageEngine implements StorageEngine {
       // Distinct placeholders for the two title occurrences: rewrite()
       // converts $N → ? positionally for sqlite, so reusing $1 would
       // desync the param array.
+      //
+      // Postgres: the JSONB column usually holds a JSON-encoded STRING
+      // scalar, not an object — update() binds `JSON.stringify(conv)` and
+      // the driver serializes that JS string as a JSON string. A bare
+      // jsonb_set on those rows throws `cannot set path in scalar`
+      // (observed in prod 2026-06-12: every rename 500'd). Branch on the
+      // stored shape and preserve each row's encoding: objects get a plain
+      // jsonb_set; string scalars get unwrapped (#>> '{}'), parsed, set,
+      // and re-serialized back to a string scalar.
       const dataExpr = this.dialect.tag === "sqlite"
         ? `json_set(data, '$.title', $2)`
-        : `jsonb_set(data, '{title}', to_jsonb($2::text))`;
+        : `CASE WHEN jsonb_typeof(data) = 'object'
+             THEN jsonb_set(data, '{title}', to_jsonb($2::text))
+             ELSE to_jsonb(jsonb_set((data #>> '{}')::jsonb, '{title}', to_jsonb($2::text))::text)
+           END`;
       await this.executor.run(
         rewrite(
           `UPDATE conversations SET title = $1, data = ${dataExpr}, updated_at = $3 WHERE id = $4`,