@cognipeer/agent-sdk 0.9.3 → 0.9.4

package/README.md

@@ -417,6 +417,8 @@ You can disable payload capture with `logData: false` to keep only metrics, or c
 
 Each session/event also carries OTel-compatible correlation identifiers (`traceId`, `rootSpanId`, `spanId`, `parentSpanId`) so you can stitch agent traces into distributed telemetry pipelines.
 
+Pass `tracing: { metadata: { ... } }` to attach arbitrary key-value tags (e.g. `{ complexity: "complex" }`) to every payload sent to the sink. The SDK does not interpret these tags itself — they're forwarded as-is so a downstream consumer (e.g. Console) can use them as reporting/attribution dimensions.
+
 ## Development
 
 Install dependencies and build the package:

package/dist/index.cjs

@@ -1162,9 +1162,9 @@ async function postStreamingSessionStart(baseUrl, headers, payload) {
   const url = `${baseUrl.replace(/\/$/, "")}/stream/${payload.sessionId}/start`;
   await postJsonReliable(url, headers, payload, { retry: true });
 }
-async function postStreamingEvent(baseUrl, headers, sessionId, event) {
+async function postStreamingEvent(baseUrl, headers, sessionId, event, metadata) {
   const url = `${baseUrl.replace(/\/$/, "")}/stream/${sessionId}/events`;
-  await postJsonReliable(url, headers, { event }, { retry: false });
+  await postJsonReliable(url, headers, { event, metadata }, { retry: false });
 }
 async function postStreamingSessionEnd(baseUrl, headers, payload) {
   const url = `${baseUrl.replace(/\/$/, "")}/stream/${payload.sessionId}/end`;
@@ -1271,7 +1271,8 @@ function traceSessionToOtlp(session) {
     stringAttr("cognipeer.session.id", session.sessionId),
     stringAttr("cognipeer.thread.id", session.threadId),
     stringAttr("cognipeer.agent.model", session.agent?.model),
-    stringAttr("cognipeer.agent.provider", session.agent?.provider)
+    stringAttr("cognipeer.agent.provider", session.agent?.provider),
+    ...Object.entries(session.metadata || {}).map(([key, value]) => stringAttr(`cognipeer.metadata.${key}`, value))
   ].filter(Boolean);
   const rootAttrs = [
     stringAttr("cognipeer.session.status", session.status),
@@ -1646,6 +1647,7 @@ function createTraceSession(opts) {
     rootSpanId,
     threadId: opts.tracing?.threadId,
     configAgentName: opts.tracing?.agentName?.trim() || void 0,
+    configMetadata: opts.tracing?.metadata && Object.keys(opts.tracing.metadata).length > 0 ? opts.tracing.metadata : void 0,
     startedAt: Date.now(),
     resolvedConfig: cfg,
     events: [],
@@ -1684,6 +1686,7 @@ async function startStreamingSession(session, agentRuntime) {
     threadId: session.threadId,
     startedAt: startedAtIso,
     agent: agentInfo,
+    metadata: session.configMetadata,
     config: configSnapshot
   };
   if (sink.type === "cognipeer" || sink.type === "http") {
@@ -1844,7 +1847,7 @@ function recordTraceEvent(session, event) {
   if (session.resolvedConfig.mode === "streaming" && session.sessionStarted) {
     if (sink.type === "cognipeer" || sink.type === "http") {
       const headers = sink.type === "cognipeer" ? { Authorization: `Bearer ${sink.apiKey}` } : sink.headers;
-      postStreamingEvent(sink.url, headers, session.sessionId, record).catch((err) => {
+      postStreamingEvent(sink.url, headers, session.sessionId, record, session.configMetadata).catch((err) => {
         const errMsg = err instanceof Error ? err.message : String(err);
         if (typeof console !== "undefined" && typeof console.warn === "function") {
           console.warn("[Tracing] Failed to send streaming event:", errMsg);
@@ -1896,6 +1899,7 @@ async function finalizeTraceSession(session, params = {}) {
     endedAt: endedAtIso,
     durationMs,
     agent: agentInfo || session.agentInfo,
+    metadata: session.configMetadata,
     config: configSnapshot,
     summary: session.summary,
     events: session.events,
@@ -1930,7 +1934,8 @@ async function finalizeTraceSession(session, params = {}) {
           durationMs,
           status: initialStatus,
           summary: session.summary,
-          errors: session.errors
+          errors: session.errors,
+          metadata: session.configMetadata
         });
       } else {
         await postTraceSession(sink.url, headers, payloadForSink);