@tangle-network/agent-app 0.60.200 → 0.60.202

package/dist/{chunk-2OWT3TNV.js → chunk-QQJJ2XYW.js}

@@ -1,6 +1,6 @@
 import {
   runRouterTurn
-} from "./chunk-T4BLISYH.js";
+} from "./chunk-PRER37K5.js";
 
 // src/runtime/protected-model.ts
 import {
@@ -219,4 +219,4 @@ export {
   createRouterProtectedModelPort,
   runProtectedRouterTurn
 };
-//# sourceMappingURL=chunk-2OWT3TNV.js.map
+//# sourceMappingURL=chunk-QQJJ2XYW.js.map

package/dist/public-consultation/index.js

@@ -1,7 +1,7 @@
 import {
   createChatTurnRoutes,
   streamChatRouteAsSandboxEvents
-} from "../chunk-6XXKFYIM.js";
+} from "../chunk-CMK2F3QH.js";
 import "../chunk-Q7WEEN7P.js";
 import "../chunk-UTAIRVOK.js";
 import "../chunk-RN4WPTBH.js";
@@ -17,7 +17,7 @@ import "../chunk-ZGUXI5SI.js";
 import "../chunk-6VQCFJWP.js";
 import "../chunk-LQYIBL3G.js";
 import "../chunk-XELWWXJJ.js";
-import "../chunk-BKPJFES3.js";
+import "../chunk-I4FFHWCS.js";
 
 // src/public-consultation/index.ts
 import { searchKnowledge } from "@tangle-network/agent-knowledge";

package/dist/runtime/index.js

@@ -2,7 +2,7 @@ import {
   ProtectedModelSettlementError,
   createRouterProtectedModelPort,
   runProtectedRouterTurn
-} from "../chunk-2OWT3TNV.js";
+} from "../chunk-QQJJ2XYW.js";
 import {
   DURABLE_HOP_BUDGET_MS,
   asksForLanguage,
@@ -24,7 +24,7 @@ import {
   turnKnowledgeInstructions,
   workspaceKnowledgeForTurn,
   workspaceTurnCheckpoints
-} from "../chunk-T4BLISYH.js";
+} from "../chunk-PRER37K5.js";
 import "../chunk-7XQIY2LU.js";
 import {
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
@@ -52,7 +52,7 @@ import {
   resolveCatalogModelId,
   sortModelsByFreshness
 } from "../chunk-AMUXRAUO.js";
-import "../chunk-BKPJFES3.js";
+import "../chunk-I4FFHWCS.js";
 
 // src/runtime/certified-delivery.ts
 import {

package/dist/runtime/router-turn.js

@@ -11,11 +11,11 @@ import {
   turnKnowledgeInstructions,
   workspaceKnowledgeForTurn,
   workspaceTurnCheckpoints
-} from "../chunk-T4BLISYH.js";
+} from "../chunk-PRER37K5.js";
 import "../chunk-7XQIY2LU.js";
 import "../chunk-D6UJEOZQ.js";
 import "../chunk-AMUXRAUO.js";
-import "../chunk-BKPJFES3.js";
+import "../chunk-I4FFHWCS.js";
 export {
   DURABLE_HOP_BUDGET_MS,
   asksForLanguage,

package/dist/turn-trace/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * `@tangle-network/agent-app/turn-trace` — one trace per agent turn.
  *
- * The recorder and the Router/Sandbox helpers are runtime-neutral. The OTLP
- * sink imports the agent-runtime root, so a browser bundle must not import this
- * entry; server code imports it for `createIntelligenceTurnTraceSink`.
+ * The recorder, the Router/Sandbox helpers and the OTLP sink import nothing but
+ * each other, so a Worker, a Durable Object and Node all bundle this entry
+ * as it is. The sink needs `fetch` and a tenant key, so it is server code.
  */
 export * from './recorder';
 export * from './server-timing';

package/dist/turn-trace/index.js

@@ -10,20 +10,38 @@ import {
   isTraceId,
   summarizeTurnSpans,
   turnTraceId
-} from "../chunk-BKPJFES3.js";
+} from "../chunk-I4FFHWCS.js";
 
 // src/turn-trace/otel.ts
-import {
-  createOtelExporter,
-  padSpanId,
-  padTraceId,
-  toOtelAttributes
-} from "@tangle-network/agent-runtime";
-var SPAN_KIND = { "model.call": "LLM", "tool.call": "TOOL" };
+function attributes(record) {
+  return Object.entries(record).flatMap(([key, value]) => {
+    if (typeof value === "number" && !Number.isFinite(value)) return [];
+    return [{
+      key,
+      value: typeof value === "number" ? Number.isInteger(value) ? { intValue: value.toString() } : { doubleValue: value } : typeof value === "boolean" ? { boolValue: value } : { stringValue: value }
+    }];
+  });
+}
+function otlpTraceId(traceId) {
+  if (/^[0-9a-f]{32}$/.test(traceId)) return traceId;
+  const dashless = traceId.replace(/-/g, "");
+  if (/^[0-9a-f]{32}$/.test(dashless)) return dashless;
+  return hexId(traceId, 32);
+}
+function hexId(input, length) {
+  const hashes = [2166136261, 2654435769, 2246822507, 3266489909];
+  for (const byte of new TextEncoder().encode(input)) {
+    for (let lane = 0; lane < hashes.length; lane += 1) hashes[lane] = Math.imul(hashes[lane] ^ byte + lane, 16777619);
+  }
+  let out = hashes.map((hash) => (hash >>> 0).toString(16).padStart(8, "0")).join("");
+  while (out.length < length) out += hexId(`${input}:${out.length}`, 32);
+  return out.slice(0, length);
+}
 var msToNs = (ms) => (BigInt(Math.floor(ms)) * 1000000n).toString();
+var SPAN_KIND = { "model.call": "LLM", "tool.call": "TOOL" };
 function buildTurnTraceOtelSpans(snapshot, labels = {}) {
-  const traceId = padTraceId(snapshot.traceId);
-  const root = padSpanId(snapshot.rootSpanId);
+  const traceId = otlpTraceId(snapshot.traceId);
+  const root = snapshot.rootSpanId;
   const { summary } = snapshot;
   const rootAttrs = {
     ...labels,
@@ -51,7 +69,7 @@ function buildTurnTraceOtelSpans(snapshot, labels = {}) {
     kind: 1,
     startTimeUnixNano: msToNs(snapshot.startedAt),
     endTimeUnixNano: msToNs(snapshot.endedAt),
-    attributes: toOtelAttributes(rootAttrs),
+    attributes: attributes(rootAttrs),
     status: snapshot.status === "ok" ? { code: 1 } : { code: 2, ...snapshot.error ? { message: snapshot.error } : {} }
   }];
   for (const span of snapshot.spans) {
@@ -66,42 +84,49 @@ function buildTurnTraceOtelSpans(snapshot, labels = {}) {
     };
     spans.push({
       traceId,
-      spanId: padSpanId(span.spanId),
-      parentSpanId: padSpanId(span.parentSpanId),
+      spanId: span.spanId,
+      parentSpanId: span.parentSpanId,
       name: span.name,
       kind: 1,
       startTimeUnixNano: msToNs(span.startMs),
       endTimeUnixNano: msToNs(span.endMs),
-      attributes: toOtelAttributes(attrs),
+      attributes: attributes(attrs),
       status: span.error ? { code: 2, message: span.error } : { code: 1 }
     });
   }
   return spans;
 }
 var DEFAULT_INTELLIGENCE_BASE_URL = "https://intelligence.tangle.tools";
+var SCOPE = { name: "@tangle-network/agent-app", version: "turn-trace" };
 function createIntelligenceTurnTraceSink(options) {
-  let exporter;
-  const exporterFor = (apiKey) => {
-    exporter ??= createOtelExporter({
-      endpoint: `${(options.baseUrl ?? DEFAULT_INTELLIGENCE_BASE_URL).replace(/\/+$/, "")}/v1/otlp`,
-      headers: { authorization: `Bearer ${apiKey}` },
-      serviceName: options.project,
-      resourceAttributes: { "tangle.project": options.project }
-    });
-    return exporter;
+  const url = `${(options.baseUrl ?? DEFAULT_INTELLIGENCE_BASE_URL).replace(/\/+$/, "")}/v1/otlp/v1/traces`;
+  const fail = (reason) => {
+    try {
+      options.onError?.(reason.slice(0, 200));
+    } catch {
+    }
   };
   return async (snapshot, labels) => {
     if (!options.apiKey) return;
     try {
-      const sink = exporterFor(options.apiKey);
-      if (!sink) return;
-      for (const span of buildTurnTraceOtelSpans(snapshot, { project: options.project, ...labels })) sink.exportSpan(span);
-      await sink.flush();
+      const body = {
+        resourceSpans: [{
+          resource: { attributes: attributes({ "service.name": options.project, "tangle.project": options.project }) },
+          scopeSpans: [{ scope: SCOPE, spans: buildTurnTraceOtelSpans(snapshot, { project: options.project, ...labels }) }]
+        }]
+      };
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${options.apiKey}` },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(options.timeoutMs ?? 5e3)
+      });
+      const text = await response.text();
+      if (!response.ok) return fail(`HTTP ${response.status} from the OTLP ingest`);
+      const rejected = Number(JSON.parse(text || "{}").partialSuccess?.rejectedSpans ?? 0);
+      if (rejected > 0) fail(`the OTLP ingest rejected ${rejected} spans`);
     } catch (error) {
-      try {
-        options.onError?.(error instanceof Error ? error.message.slice(0, 160) : "turn trace export failed");
-      } catch {
-      }
+      fail(error instanceof Error ? error.message : "turn trace export failed");
     }
   };
 }
@@ -112,6 +137,7 @@ export {
   createTurnTrace,
   isTraceId,
   nextCallIndex,
+  otlpTraceId,
   parseServerTiming,
   serverTimingAttrs,
   summarizeTurnSpans,

package/dist/turn-trace/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/turn-trace/otel.ts"],"sourcesContent":["/**\n * A finished turn trace as OTLP spans, sent to Tangle Intelligence.\n *\n * The span builders and the exporter are agent-runtime's (`createOtelExporter`,\n * `toOtelAttributes`, `padTraceId`); this file only maps the turn's tree onto\n * them, using the GenAI semantic-convention keys the runtime's own builders\n * write (`gen_ai.operation.name`, `gen_ai.request.model`, `gen_ai.usage.*`,\n * `gen_ai.tool.name`) and OpenInference's span kind.\n *\n * Server only: it imports the runtime root, which a browser bundle must not.\n */\nimport {\n  createOtelExporter,\n  padSpanId,\n  padTraceId,\n  toOtelAttributes,\n  type OtelExporter,\n  type OtelSpan,\n} from '@tangle-network/agent-runtime'\nimport { TURN_SPAN_KINDS, type TurnSpanAttrs, type TurnSpanKind, type TurnTraceSink, type TurnTraceSnapshot } from './recorder'\n\n/** OpenInference span kind per turn span: model calls read as LLM, tool calls as TOOL. */\nconst SPAN_KIND: Partial<Record<string, 'LLM' | 'TOOL'>> = { 'model.call': 'LLM', 'tool.call': 'TOOL' }\n\nconst msToNs = (ms: number) => (BigInt(Math.floor(ms)) * 1_000_000n).toString()\n\n/**\n * The root span (`agent_app.turn`) carries the host's labels and the turn's\n * numbers: wall time, the share inside child spans, and the time credited to\n * each kind of span. Children follow under it.\n */\nexport function buildTurnTraceOtelSpans(snapshot: TurnTraceSnapshot, labels: TurnSpanAttrs = {}): OtelSpan[] {\n  const traceId = padTraceId(snapshot.traceId)\n  const root = padSpanId(snapshot.rootSpanId)\n  const { summary } = snapshot\n  const rootAttrs: Record<string, string | number | boolean> = {\n    ...labels,\n    'openinference.span.kind': 'CHAIN',\n    'tangle.execution_id': snapshot.executionId,\n    'tangle.trace_id': snapshot.traceId,\n    'tangle.started_at_ms': snapshot.startedAt,\n    'tangle.completed_at_ms': snapshot.endedAt,\n    'tangle.duration_ms': summary.wallMs,\n    'tangle.turn.wall_ms': summary.wallMs,\n    'tangle.turn.covered_ms': summary.coveredMs,\n    'tangle.turn.coverage_pct': summary.coveragePct,\n    'tangle.turn.uncovered_ms': summary.uncoveredMs,\n    'tangle.turn.largest_gap_ms': summary.largestGapMs,\n    'tangle.turn.spans': summary.spans,\n    'tangle.turn.model_calls': summary.modelCalls,\n    'tangle.turn.tool_calls': summary.toolCalls,\n    ...(summary.dropped ? { 'tangle.turn.spans_dropped': summary.dropped } : {}),\n    ...Object.fromEntries(TURN_SPAN_KINDS.map((kind: TurnSpanKind) => [`tangle.turn.${kind}_ms`, summary.byKind[kind]])),\n  }\n  const spans: OtelSpan[] = [{\n    traceId,\n    spanId: root,\n    name: 'agent_app.turn',\n    kind: 1,\n    startTimeUnixNano: msToNs(snapshot.startedAt),\n    endTimeUnixNano: msToNs(snapshot.endedAt),\n    attributes: toOtelAttributes(rootAttrs),\n    status: snapshot.status === 'ok' ? { code: 1 } : { code: 2, ...(snapshot.error ? { message: snapshot.error } : {}) },\n  }]\n  for (const span of snapshot.spans) {\n    const attrs: Record<string, string | number | boolean> = {\n      ...span.attrs,\n      'openinference.span.kind': SPAN_KIND[span.name] ?? 'CHAIN',\n      'tangle.turn.span_kind': span.kind,\n      'agent.parent.confidence': 'explicit',\n      ...(span.name === 'tool.call' ? { 'gen_ai.operation.name': 'execute_tool' } : {}),\n      ...(span.unfinished ? { 'tangle.turn.unfinished': true } : {}),\n      ...(span.error ? { 'error.message': span.error } : {}),\n    }\n    spans.push({\n      traceId,\n      spanId: padSpanId(span.spanId),\n      parentSpanId: padSpanId(span.parentSpanId),\n      name: span.name,\n      kind: 1,\n      startTimeUnixNano: msToNs(span.startMs),\n      endTimeUnixNano: msToNs(span.endMs),\n      attributes: toOtelAttributes(attrs),\n      status: span.error ? { code: 2, message: span.error } : { code: 1 },\n    })\n  }\n  return spans\n}\n\nexport interface IntelligenceTurnTraceSinkOptions {\n  /** The Intelligence project the spans belong to, e.g. `legal-agent`. */\n  project: string\n  /** The tenant key the ingest requires. Without one the sink does nothing. */\n  apiKey: string | undefined\n  /** Default `https://intelligence.tangle.tools`; spans go to `<base>/v1/otlp`. */\n  baseUrl?: string\n  /** Called with a short reason when a delivery fails. Never receives span content. */\n  onError?: (reason: string) => void\n}\n\nconst DEFAULT_INTELLIGENCE_BASE_URL = 'https://intelligence.tangle.tools'\n\n/**\n * The sink a chat route or a Worker turn hands each finished trace to. The\n * exporter is built on first use, inside a request, because a Worker refuses a\n * timer at module scope. Each trace is flushed before the sink returns, so a\n * host that runs it under `waitUntil` keeps the isolate alive until delivery.\n */\nexport function createIntelligenceTurnTraceSink(options: IntelligenceTurnTraceSinkOptions): TurnTraceSink {\n  let exporter: OtelExporter | undefined\n  const exporterFor = (apiKey: string): OtelExporter | undefined => {\n    exporter ??= createOtelExporter({\n      endpoint: `${(options.baseUrl ?? DEFAULT_INTELLIGENCE_BASE_URL).replace(/\\/+$/, '')}/v1/otlp`,\n      headers: { authorization: `Bearer ${apiKey}` },\n      serviceName: options.project,\n      resourceAttributes: { 'tangle.project': options.project },\n    })\n    return exporter\n  }\n  return async (snapshot, labels) => {\n    if (!options.apiKey) return\n    try {\n      const sink = exporterFor(options.apiKey)\n      if (!sink) return\n      for (const span of buildTurnTraceOtelSpans(snapshot, { project: options.project, ...labels })) sink.exportSpan(span)\n      await sink.flush()\n    } catch (error) {\n      try { options.onError?.(error instanceof Error ? error.message.slice(0, 160) : 'turn trace export failed') } catch { /* telemetry only */ }\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/turn-trace/otel.ts"],"sourcesContent":["/**\n * A finished turn trace as OTLP spans, sent to Tangle Intelligence.\n *\n * The attribute vocabulary is the one agent-runtime's span builders write\n * (`gen_ai.operation.name`, `gen_ai.request.model`, `gen_ai.usage.*`,\n * `gen_ai.tool.name`, OpenInference's span kind, `agent.parent.confidence`), and\n * the wire shape is the one its `createOtelExporter` posts to\n * `<base>/v1/otlp/v1/traces`.\n *\n * It does not import agent-runtime. The runtime root pulls the whole sandbox\n * SDK into a Worker bundle, and the SDK's chain client imports `viem`, which a\n * Worker build cannot resolve (Hospitality's release failed on exactly that);\n * and its exporter keeps a timer a Worker refuses at module scope. One OTLP\n * POST per finished turn needs neither.\n */\nimport { TURN_SPAN_KINDS, type TurnSpanAttrs, type TurnSpanKind, type TurnTraceSink, type TurnTraceSnapshot } from './recorder'\n\n/** One OTLP/JSON span, as Intelligence's ingest reads it. */\nexport interface OtlpSpan {\n  traceId: string\n  spanId: string\n  parentSpanId?: string\n  name: string\n  kind: number\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes: Array<{ key: string; value: { stringValue?: string; intValue?: string; doubleValue?: number; boolValue?: boolean } }>\n  status: { code: number; message?: string }\n}\n\nfunction attributes(record: Record<string, string | number | boolean>): OtlpSpan['attributes'] {\n  return Object.entries(record).flatMap(([key, value]) => {\n    if (typeof value === 'number' && !Number.isFinite(value)) return []\n    return [{\n      key,\n      value: typeof value === 'number' ? (Number.isInteger(value) ? { intValue: value.toString() } : { doubleValue: value })\n        : typeof value === 'boolean' ? { boolValue: value } : { stringValue: value },\n    }]\n  })\n}\n\n/**\n * A Tangle trace id as the 32-hex OTLP trace id. The mapping is the Sandbox SDK's `otelTraceIdForTangleTrace`, so a\n * Sandbox trace export of the same turn lands in the same OTLP trace. An id that is already 32 hex, or a UUID, is used as it is.\n */\nexport function otlpTraceId(traceId: string): string {\n  if (/^[0-9a-f]{32}$/.test(traceId)) return traceId\n  const dashless = traceId.replace(/-/g, '')\n  if (/^[0-9a-f]{32}$/.test(dashless)) return dashless\n  return hexId(traceId, 32)\n}\n\nfunction hexId(input: string, length: number): string {\n  const hashes = [2166136261, 2654435769, 2246822507, 3266489909]\n  for (const byte of new TextEncoder().encode(input)) {\n    for (let lane = 0; lane < hashes.length; lane += 1) hashes[lane] = Math.imul((hashes[lane] as number) ^ (byte + lane), 16777619)\n  }\n  let out = hashes.map((hash) => (hash >>> 0).toString(16).padStart(8, '0')).join('')\n  while (out.length < length) out += hexId(`${input}:${out.length}`, 32)\n  return out.slice(0, length)\n}\n\nconst msToNs = (ms: number) => (BigInt(Math.floor(ms)) * 1_000_000n).toString()\n\n/** OpenInference span kind per turn span: model calls read as LLM, tool calls as TOOL. */\nconst SPAN_KIND: Partial<Record<string, 'LLM' | 'TOOL'>> = { 'model.call': 'LLM', 'tool.call': 'TOOL' }\n\n/**\n * The root span (`agent_app.turn`) carries the host's labels and the turn's\n * numbers: wall time, the share inside child spans, and the time credited to\n * each kind of span. Children follow under it.\n */\nexport function buildTurnTraceOtelSpans(snapshot: TurnTraceSnapshot, labels: TurnSpanAttrs = {}): OtlpSpan[] {\n  const traceId = otlpTraceId(snapshot.traceId)\n  const root = snapshot.rootSpanId\n  const { summary } = snapshot\n  const rootAttrs: Record<string, string | number | boolean> = {\n    ...labels,\n    'openinference.span.kind': 'CHAIN',\n    'tangle.execution_id': snapshot.executionId,\n    'tangle.trace_id': snapshot.traceId,\n    'tangle.started_at_ms': snapshot.startedAt,\n    'tangle.completed_at_ms': snapshot.endedAt,\n    'tangle.duration_ms': summary.wallMs,\n    'tangle.turn.wall_ms': summary.wallMs,\n    'tangle.turn.covered_ms': summary.coveredMs,\n    'tangle.turn.coverage_pct': summary.coveragePct,\n    'tangle.turn.uncovered_ms': summary.uncoveredMs,\n    'tangle.turn.largest_gap_ms': summary.largestGapMs,\n    'tangle.turn.spans': summary.spans,\n    'tangle.turn.model_calls': summary.modelCalls,\n    'tangle.turn.tool_calls': summary.toolCalls,\n    ...(summary.dropped ? { 'tangle.turn.spans_dropped': summary.dropped } : {}),\n    ...Object.fromEntries(TURN_SPAN_KINDS.map((kind: TurnSpanKind) => [`tangle.turn.${kind}_ms`, summary.byKind[kind]])),\n  }\n  const spans: OtlpSpan[] = [{\n    traceId,\n    spanId: root,\n    name: 'agent_app.turn',\n    kind: 1,\n    startTimeUnixNano: msToNs(snapshot.startedAt),\n    endTimeUnixNano: msToNs(snapshot.endedAt),\n    attributes: attributes(rootAttrs),\n    status: snapshot.status === 'ok' ? { code: 1 } : { code: 2, ...(snapshot.error ? { message: snapshot.error } : {}) },\n  }]\n  for (const span of snapshot.spans) {\n    const attrs: Record<string, string | number | boolean> = {\n      ...span.attrs,\n      'openinference.span.kind': SPAN_KIND[span.name] ?? 'CHAIN',\n      'tangle.turn.span_kind': span.kind,\n      'agent.parent.confidence': 'explicit',\n      ...(span.name === 'tool.call' ? { 'gen_ai.operation.name': 'execute_tool' } : {}),\n      ...(span.unfinished ? { 'tangle.turn.unfinished': true } : {}),\n      ...(span.error ? { 'error.message': span.error } : {}),\n    }\n    spans.push({\n      traceId,\n      spanId: span.spanId,\n      parentSpanId: span.parentSpanId,\n      name: span.name,\n      kind: 1,\n      startTimeUnixNano: msToNs(span.startMs),\n      endTimeUnixNano: msToNs(span.endMs),\n      attributes: attributes(attrs),\n      status: span.error ? { code: 2, message: span.error } : { code: 1 },\n    })\n  }\n  return spans\n}\n\nexport interface IntelligenceTurnTraceSinkOptions {\n  /** The Intelligence project the spans belong to, e.g. `legal-agent`. */\n  project: string\n  /** The tenant key the ingest requires. Without one the sink does nothing. */\n  apiKey: string | undefined\n  /** Default `https://intelligence.tangle.tools`; spans go to `<base>/v1/otlp/v1/traces`. */\n  baseUrl?: string\n  /** Called with a short reason when a delivery fails. Never receives span content. */\n  onError?: (reason: string) => void\n  /** Milliseconds one POST may take (default 5000). */\n  timeoutMs?: number\n}\n\nconst DEFAULT_INTELLIGENCE_BASE_URL = 'https://intelligence.tangle.tools'\nconst SCOPE = { name: '@tangle-network/agent-app', version: 'turn-trace' }\n\n/**\n * The sink a chat route or a Worker turn hands each finished trace to: one OTLP POST per turn, awaited, so a host that\n * runs it under `waitUntil` keeps the isolate alive until delivery. It never throws; a failure goes to `onError`.\n */\nexport function createIntelligenceTurnTraceSink(options: IntelligenceTurnTraceSinkOptions): TurnTraceSink {\n  const url = `${(options.baseUrl ?? DEFAULT_INTELLIGENCE_BASE_URL).replace(/\\/+$/, '')}/v1/otlp/v1/traces`\n  const fail = (reason: string) => { try { options.onError?.(reason.slice(0, 200)) } catch { /* telemetry only */ } }\n  return async (snapshot, labels) => {\n    if (!options.apiKey) return\n    try {\n      const body = {\n        resourceSpans: [{\n          resource: { attributes: attributes({ 'service.name': options.project, 'tangle.project': options.project }) },\n          scopeSpans: [{ scope: SCOPE, spans: buildTurnTraceOtelSpans(snapshot, { project: options.project, ...labels }) }],\n        }],\n      }\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json', authorization: `Bearer ${options.apiKey}` },\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(options.timeoutMs ?? 5_000),\n      })\n      const text = await response.text()\n      if (!response.ok) return fail(`HTTP ${response.status} from the OTLP ingest`)\n      // A 2xx can still refuse part of a batch (`partialSuccess.rejectedSpans`).\n      const rejected = Number((JSON.parse(text || '{}') as { partialSuccess?: { rejectedSpans?: unknown } }).partialSuccess?.rejectedSpans ?? 0)\n      if (rejected > 0) fail(`the OTLP ingest rejected ${rejected} spans`)\n    } catch (error) {\n      fail(error instanceof Error ? error.message : 'turn trace export failed')\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/turn-trace/otel.d.ts

@@ -1,36 +1,67 @@
 /**
  * A finished turn trace as OTLP spans, sent to Tangle Intelligence.
  *
- * The span builders and the exporter are agent-runtime's (`createOtelExporter`,
- * `toOtelAttributes`, `padTraceId`); this file only maps the turn's tree onto
- * them, using the GenAI semantic-convention keys the runtime's own builders
- * write (`gen_ai.operation.name`, `gen_ai.request.model`, `gen_ai.usage.*`,
- * `gen_ai.tool.name`) and OpenInference's span kind.
+ * The attribute vocabulary is the one agent-runtime's span builders write
+ * (`gen_ai.operation.name`, `gen_ai.request.model`, `gen_ai.usage.*`,
+ * `gen_ai.tool.name`, OpenInference's span kind, `agent.parent.confidence`), and
+ * the wire shape is the one its `createOtelExporter` posts to
+ * `<base>/v1/otlp/v1/traces`.
  *
- * Server only: it imports the runtime root, which a browser bundle must not.
+ * It does not import agent-runtime. The runtime root pulls the whole sandbox
+ * SDK into a Worker bundle, and the SDK's chain client imports `viem`, which a
+ * Worker build cannot resolve (Hospitality's release failed on exactly that);
+ * and its exporter keeps a timer a Worker refuses at module scope. One OTLP
+ * POST per finished turn needs neither.
  */
-import { type OtelSpan } from '@tangle-network/agent-runtime';
 import { type TurnSpanAttrs, type TurnTraceSink, type TurnTraceSnapshot } from './recorder';
+/** One OTLP/JSON span, as Intelligence's ingest reads it. */
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: Array<{
+        key: string;
+        value: {
+            stringValue?: string;
+            intValue?: string;
+            doubleValue?: number;
+            boolValue?: boolean;
+        };
+    }>;
+    status: {
+        code: number;
+        message?: string;
+    };
+}
+/**
+ * A Tangle trace id as the 32-hex OTLP trace id. The mapping is the Sandbox SDK's `otelTraceIdForTangleTrace`, so a
+ * Sandbox trace export of the same turn lands in the same OTLP trace. An id that is already 32 hex, or a UUID, is used as it is.
+ */
+export declare function otlpTraceId(traceId: string): string;
 /**
  * The root span (`agent_app.turn`) carries the host's labels and the turn's
  * numbers: wall time, the share inside child spans, and the time credited to
  * each kind of span. Children follow under it.
  */
-export declare function buildTurnTraceOtelSpans(snapshot: TurnTraceSnapshot, labels?: TurnSpanAttrs): OtelSpan[];
+export declare function buildTurnTraceOtelSpans(snapshot: TurnTraceSnapshot, labels?: TurnSpanAttrs): OtlpSpan[];
 export interface IntelligenceTurnTraceSinkOptions {
     /** The Intelligence project the spans belong to, e.g. `legal-agent`. */
     project: string;
     /** The tenant key the ingest requires. Without one the sink does nothing. */
     apiKey: string | undefined;
-    /** Default `https://intelligence.tangle.tools`; spans go to `<base>/v1/otlp`. */
+    /** Default `https://intelligence.tangle.tools`; spans go to `<base>/v1/otlp/v1/traces`. */
     baseUrl?: string;
     /** Called with a short reason when a delivery fails. Never receives span content. */
     onError?: (reason: string) => void;
+    /** Milliseconds one POST may take (default 5000). */
+    timeoutMs?: number;
 }
 /**
- * The sink a chat route or a Worker turn hands each finished trace to. The
- * exporter is built on first use, inside a request, because a Worker refuses a
- * timer at module scope. Each trace is flushed before the sink returns, so a
- * host that runs it under `waitUntil` keeps the isolate alive until delivery.
+ * The sink a chat route or a Worker turn hands each finished trace to: one OTLP POST per turn, awaited, so a host that
+ * runs it under `waitUntil` keeps the isolate alive until delivery. It never throws; a failure goes to `onError`.
  */
 export declare function createIntelligenceTurnTraceSink(options: IntelligenceTurnTraceSinkOptions): TurnTraceSink;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.60.200",
+  "version": "0.60.202",
   "packageManager": "pnpm@11.24.0",
   "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
   "keywords": [