@cognipeer/agent-sdk 0.9.3 → 0.9.4

package/dist/index.d.cts

@@ -622,6 +622,11 @@ type TracingConfig = {
      * when the same agent implementation runs under several logical names.
      */
     agentName?: string;
+    /**
+     * Arbitrary key-value tags forwarded to every tracing payload for downstream
+     * attribution/reporting; not interpreted by the SDK itself.
+     */
+    metadata?: Record<string, string>;
 };
 type SmartAgentTracingConfig = TracingConfig;
 type AgentOptions = {
@@ -1350,6 +1355,8 @@ type TraceSessionFile = {
         model?: string;
         provider?: string;
     };
+    /** Arbitrary key-value tags from `TracingConfig.metadata`, forwarded as-is for downstream attribution/reporting. */
+    metadata?: Record<string, string>;
     config: TraceSessionConfigSnapshot;
     summary: TraceSessionSummary;
     events: TraceEventRecord[];
@@ -1398,6 +1405,8 @@ type TraceSessionRuntime = {
     };
     /** Caller-supplied agent name override (from TracingConfig.agentName). */
     configAgentName?: string;
+    /** Caller-supplied attribution tags (from TracingConfig.metadata). */
+    configMetadata?: Record<string, string>;
     resolvedConfig: ResolvedTraceConfig;
     events: TraceEventRecord[];
     summary: TraceSessionSummary;

package/dist/index.d.ts

@@ -622,6 +622,11 @@ type TracingConfig = {
      * when the same agent implementation runs under several logical names.
      */
     agentName?: string;
+    /**
+     * Arbitrary key-value tags forwarded to every tracing payload for downstream
+     * attribution/reporting; not interpreted by the SDK itself.
+     */
+    metadata?: Record<string, string>;
 };
 type SmartAgentTracingConfig = TracingConfig;
 type AgentOptions = {
@@ -1350,6 +1355,8 @@ type TraceSessionFile = {
         model?: string;
         provider?: string;
     };
+    /** Arbitrary key-value tags from `TracingConfig.metadata`, forwarded as-is for downstream attribution/reporting. */
+    metadata?: Record<string, string>;
     config: TraceSessionConfigSnapshot;
     summary: TraceSessionSummary;
     events: TraceEventRecord[];
@@ -1398,6 +1405,8 @@ type TraceSessionRuntime = {
     };
     /** Caller-supplied agent name override (from TracingConfig.agentName). */
     configAgentName?: string;
+    /** Caller-supplied attribution tags (from TracingConfig.metadata). */
+    configMetadata?: Record<string, string>;
     resolvedConfig: ResolvedTraceConfig;
     events: TraceEventRecord[];
     summary: TraceSessionSummary;

package/dist/index.mjs

@@ -1152,9 +1152,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`;
@@ -1261,7 +1261,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),
@@ -1636,6 +1637,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: [],
@@ -1674,6 +1676,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") {
@@ -1834,7 +1837,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);
@@ -1886,6 +1889,7 @@ async function finalizeTraceSession(session, params = {}) {
     endedAt: endedAtIso,
     durationMs,
     agent: agentInfo || session.agentInfo,
+    metadata: session.configMetadata,
     config: configSnapshot,
     summary: session.summary,
     events: session.events,
@@ -1920,7 +1924,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);