@tangle-network/agent-runtime 0.115.1 → 0.116.0

package/dist/trace-propagation-B-pL7xn_.js

@@ -1,57 +0,0 @@
-import { a as createOtelExporter, n as buildLoopOtelSpans } from "./otel-export-CPZTSADj.js";
-//#region src/mcp/trace-propagation.ts
-/**
-* Read trace context from the process environment.
-* Returns a context with inherited ids or a freshly generated root.
-*/
-function readTraceContextFromEnv() {
-	return {
-		traceId: process.env.TRACE_ID || generateTraceId(),
-		parentSpanId: process.env.PARENT_SPAN_ID || void 0
-	};
-}
-/**
-* Create a LoopTraceEmitter that:
-*   1. Parents all spans under the inherited PARENT_SPAN_ID.
-*   2. Exports spans to OTEL when OTEL_EXPORTER_OTLP_ENDPOINT is set.
-*
-* Returns both the emitter and the optional exporter handle for shutdown.
-*/
-function createPropagatingTraceEmitter(ctx) {
-	const exporter = createOtelExporter();
-	const buffers = /* @__PURE__ */ new Map();
-	return {
-		emitter: { emit(event) {
-			if (!exporter) return;
-			const buf = buffers.get(event.runId);
-			if (buf) buf.push(event);
-			else buffers.set(event.runId, [event]);
-			if (event.kind === "loop.ended") {
-				const events = buffers.get(event.runId) ?? [event];
-				buffers.delete(event.runId);
-				for (const span of buildLoopOtelSpans(events, ctx.traceId, ctx.parentSpanId)) exporter.exportSpan(span);
-			}
-		} },
-		exporter,
-		context: ctx
-	};
-}
-/**
-* Build env vars to pass to a child MCP subprocess so it inherits the
-* current trace context.
-*/
-function traceContextToEnv(ctx) {
-	const env = { TRACE_ID: ctx.traceId };
-	if (ctx.parentSpanId) env.PARENT_SPAN_ID = ctx.parentSpanId;
-	return env;
-}
-function generateTraceId() {
-	const bytes = /* @__PURE__ */ new Uint8Array(16);
-	if (typeof globalThis.crypto?.getRandomValues === "function") globalThis.crypto.getRandomValues(bytes);
-	else for (let i = 0; i < 16; i++) bytes[i] = Math.floor(Math.random() * 256);
-	return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
-}
-//#endregion
-export { readTraceContextFromEnv as n, traceContextToEnv as r, createPropagatingTraceEmitter as t };
-
-//# sourceMappingURL=trace-propagation-B-pL7xn_.js.map

package/dist/trace-propagation-B-pL7xn_.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace-propagation-B-pL7xn_.js","names":[],"sources":["../src/mcp/trace-propagation.ts"],"sourcesContent":["/**\n *\n * Trace context propagation for MCP subprocess.\n *\n * When the MCP server is launched as a child process by a sandbox harness,\n * the parent passes trace context via environment variables:\n *\n *   TRACE_ID=<current-run-trace-id>\n *   PARENT_SPAN_ID=<span-that-dispatched-the-delegation>\n *\n * The MCP server reads these at startup and uses them as the root of its\n * internal trace tree. All spans emitted by `runAgentRounds` invocations inside\n * the MCP are children of the parent's delegation span.\n *\n * When these env vars are absent, the MCP generates a fresh trace root —\n * the server operates standalone without trace joining.\n *\n * @experimental\n */\n\nimport type { OtelExporter } from '../otel-export'\nimport { buildLoopOtelSpans, createOtelExporter } from '../otel-export'\nimport type { LoopTraceEmitter, LoopTraceEvent } from '../runtime/types'\n\nexport interface TraceContext {\n  /** Trace id inherited from the parent process, or a fresh one. */\n  traceId: string\n  /** Parent span id from the delegation that launched this MCP server. */\n  parentSpanId?: string\n}\n\n/**\n * Read trace context from the process environment.\n * Returns a context with inherited ids or a freshly generated root.\n */\nexport function readTraceContextFromEnv(): TraceContext {\n  const traceId = process.env.TRACE_ID || generateTraceId()\n  const parentSpanId = process.env.PARENT_SPAN_ID || undefined\n  return { traceId, parentSpanId }\n}\n\n/**\n * Create a LoopTraceEmitter that:\n *   1. Parents all spans under the inherited PARENT_SPAN_ID.\n *   2. Exports spans to OTEL when OTEL_EXPORTER_OTLP_ENDPOINT is set.\n *\n * Returns both the emitter and the optional exporter handle for shutdown.\n */\nexport function createPropagatingTraceEmitter(ctx: TraceContext): {\n  emitter: LoopTraceEmitter\n  exporter: OtelExporter | undefined\n  context: TraceContext\n} {\n  const exporter = createOtelExporter()\n\n  // Buffer events per loop run, then emit the full nested span tree on\n  // `loop.ended` so the topology hierarchy (loop → round → branch) reaches the\n  // OTLP collector — not a flat list of zero-duration point spans. A run that\n  // never reaches `loop.ended` (hard abort) drops its buffer; acceptable for\n  // the short-lived MCP subprocess.\n  const buffers = new Map<string, LoopTraceEvent[]>()\n\n  const emitter: LoopTraceEmitter = {\n    emit(event: LoopTraceEvent) {\n      if (!exporter) return\n      const buf = buffers.get(event.runId)\n      if (buf) buf.push(event)\n      else buffers.set(event.runId, [event])\n      if (event.kind === 'loop.ended') {\n        const events = buffers.get(event.runId) ?? [event]\n        buffers.delete(event.runId)\n        for (const span of buildLoopOtelSpans(events, ctx.traceId, ctx.parentSpanId)) {\n          exporter.exportSpan(span)\n        }\n      }\n    },\n  }\n\n  return { emitter, exporter, context: ctx }\n}\n\n/**\n * Build env vars to pass to a child MCP subprocess so it inherits the\n * current trace context.\n */\nexport function traceContextToEnv(ctx: TraceContext): Record<string, string> {\n  const env: Record<string, string> = { TRACE_ID: ctx.traceId }\n  if (ctx.parentSpanId) env.PARENT_SPAN_ID = ctx.parentSpanId\n  return env\n}\n\nfunction generateTraceId(): string {\n  const bytes = new Uint8Array(16)\n  if (typeof globalThis.crypto?.getRandomValues === 'function') {\n    globalThis.crypto.getRandomValues(bytes)\n  } else {\n    for (let i = 0; i < 16; i++) bytes[i] = Math.floor(Math.random() * 256)\n  }\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('')\n}\n"],"mappings":";;;;;;AAmCA,SAAgB,0BAAwC;CAGtD,OAAO;EAAE,SAFO,QAAQ,IAAI,YAAY,gBAAgB;EAEtC,cADG,QAAQ,IAAI,kBAAkB,KAAA;CACpB;AACjC;;;;;;;;AASA,SAAgB,8BAA8B,KAI5C;CACA,MAAM,WAAW,mBAAmB;CAOpC,MAAM,0BAAU,IAAI,IAA8B;CAkBlD,OAAO;EAAE,SAAA,EAfP,KAAK,OAAuB;GAC1B,IAAI,CAAC,UAAU;GACf,MAAM,MAAM,QAAQ,IAAI,MAAM,KAAK;GACnC,IAAI,KAAK,IAAI,KAAK,KAAK;QAClB,QAAQ,IAAI,MAAM,OAAO,CAAC,KAAK,CAAC;GACrC,IAAI,MAAM,SAAS,cAAc;IAC/B,MAAM,SAAS,QAAQ,IAAI,MAAM,KAAK,KAAK,CAAC,KAAK;IACjD,QAAQ,OAAO,MAAM,KAAK;IAC1B,KAAK,MAAM,QAAQ,mBAAmB,QAAQ,IAAI,SAAS,IAAI,YAAY,GACzE,SAAS,WAAW,IAAI;GAE5B;EACF,EAGa;EAAG;EAAU,SAAS;CAAI;AAC3C;;;;;AAMA,SAAgB,kBAAkB,KAA2C;CAC3E,MAAM,MAA8B,EAAE,UAAU,IAAI,QAAQ;CAC5D,IAAI,IAAI,cAAc,IAAI,iBAAiB,IAAI;CAC/C,OAAO;AACT;AAEA,SAAS,kBAA0B;CACjC,MAAM,wBAAQ,IAAI,WAAW,EAAE;CAC/B,IAAI,OAAO,WAAW,QAAQ,oBAAoB,YAChD,WAAW,OAAO,gBAAgB,KAAK;MAEvC,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;CAExE,OAAO,MAAM,KAAK,KAAK,CAAC,CACrB,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAC3C,KAAK,EAAE;AACZ"}