@tangle-network/traces 0.7.0 → 0.8.0

package/README.md

@@ -43,7 +43,7 @@ That's the command in the demo above. The **deterministic pass** — stuck loops
 
 Add `--llm` for the **agentic analysts** (failure-mode / knowledge-gap / knowledge-poisoning / improvement); they call OpenAI and respect `--budget <usd>`.
 
-Every run also writes an **OTLP-JSONL artifact**, and you can run external engines like [HALO](https://github.com/context-labs/halo) over it with `--analyzer halo` (traces converts our spans to the canonical OpenInference shape HALO needs) — see [External engines](#external-engines-bring-your-own). Analysis is never locked to one engine.
+Every run also writes a **canonical OpenInference JSONL artifact**, so you can run external engines like [HALO](https://github.com/context-labs/halo) over it directly with `--analyzer halo` — see [External engines](#external-engines-bring-your-own). Analysis is never locked to one engine.
 
 ## What it finds
 
@@ -142,7 +142,7 @@ traces analyze --last 1 --analyzer halo --analyzer-prompt "find token waste"
 traces analyze --last 1 --analyzer halo --analyzer my-engine    # repeatable
 ```
 
-HALO needs canonical OpenInference, so `--analyzer halo` converts our spans automatically (`toCanonicalOpenInference`). HALO runs its *own* LLM (OpenAI client — set `OPENAI_BASE_URL` / `OPENAI_API_KEY`, or use HALO's provider); `--model` is forwarded to it. traces supplies the trace and drives the CLI; it doesn't pay for or configure HALO's model.
+Our OTLP artifact is **canonical OpenInference** (top-level `kind`, `resource`, `scope`), so HALO reads it directly — no conversion. HALO runs its *own* LLM (OpenAI client — set `OPENAI_BASE_URL` / `OPENAI_API_KEY`, or use HALO's provider); `--model` is forwarded to it. traces supplies the trace and drives the CLI; it doesn't pay for or configure HALO's model.
 
 **Redactors** scrub prompt/response prose with an external PII model (catching names/addresses the regex pass can't), running *after* the built-in redaction:
 

package/dist/{chunk-Q56AP2EY.js → chunk-BUD6I3ZJ.js}

@@ -25,9 +25,28 @@ function span(input) {
     attributes
   };
 }
+function toOpenInferenceSpan(s) {
+  const a = s.attributes;
+  const resourceAttrs = {};
+  if (a["service.name"] != null) resourceAttrs["service.name"] = a["service.name"];
+  if (a["agent.name"] != null) resourceAttrs["agent.name"] = a["agent.name"];
+  return {
+    trace_id: s.trace_id,
+    span_id: s.span_id,
+    parent_span_id: s.parent_span_id ?? "",
+    name: s.name,
+    kind: typeof a["openinference.span.kind"] === "string" ? a["openinference.span.kind"] : "CHAIN",
+    start_time: s.start_time,
+    end_time: s.end_time,
+    status: { code: s.status.code, message: s.status.message ?? "" },
+    resource: { attributes: resourceAttrs },
+    scope: { name: "tangle-traces", version: "" },
+    attributes: a
+  };
+}
 function serializeSpans(spans) {
   if (spans.length === 0) return "";
-  return `${spans.map((s) => JSON.stringify(s)).join("\n")}
+  return `${spans.map((s) => JSON.stringify(toOpenInferenceSpan(s))).join("\n")}
 `;
 }
 async function writeOtlpFile(spans, outPath) {
@@ -2330,6 +2349,7 @@ async function executeUpload(plan, opts = {}) {
 
 export {
   span,
+  toOpenInferenceSpan,
   serializeSpans,
   writeOtlpFile,
   analyzeSpans,

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
   selectAdapters,
   watchSessions,
   writeOtlpFile
-} from "./chunk-Q56AP2EY.js";
+} from "./chunk-BUD6I3ZJ.js";
 
 // src/cli.ts
 import { stat, writeFile } from "fs/promises";

package/dist/index.d.ts

@@ -73,7 +73,15 @@ interface SpanInput {
  * so the behavioral analyst's "no LLM data" case stays honest.
  */
 declare function span(input: SpanInput): OtlpSpan;
-/** Serialize spans to OTLP-JSONL (one span per line, trailing newline). */
+/** Project an in-memory span to a COMPLETE OpenInference span: the standard shape
+ *  OTel/OpenInference consumers (and HALO) expect — top-level `kind`, `resource`,
+ *  `scope`, and a string `parent_span_id` ("" at the root) — while keeping the
+ *  attribute vocabulary (incl. `openinference.span.kind`) our own analysts read.
+ *  One artifact feeds our pipeline, HALO, and any OpenInference tool. */
+declare function toOpenInferenceSpan(s: OtlpSpan): Record<string, unknown>;
+/** Serialize spans to OpenInference JSONL (one complete span per line). This is a
+ *  standard OpenInference representation: it feeds our analysts, HALO, and other
+ *  OpenInference tools directly — no per-tool conversion. */
 declare function serializeSpans(spans: readonly OtlpSpan[]): string;
 /** Write spans to an OTLP-JSONL file (a temp file when no path is given). */
 declare function writeOtlpFile(spans: readonly OtlpSpan[], outPath?: string): Promise<string>;
@@ -867,4 +875,4 @@ interface ExecuteOptions {
 /** Send the NEW items (or, on dryRun, write the redacted OTLP that would send). */
 declare function executeUpload(plan: UploadPlan, opts?: ExecuteOptions): Promise<UploadResult>;
 
-export { ATTR, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, CODING_REDACTION_RULES, CONTENT_CAP, ClaudeAdapter, CodexAdapter, type CollectOptions, CopilotAdapter, DEFAULT_HARNESS, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, QwenAdapter, type Redactor, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, type UploadBackend, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, alreadyUploaded, analyzeSpans, applyRedactor, capText, collectSessions, commandAnalyzer, commandRedactor, executeUpload, haloAnalyzer, knownHarnesses, listAdapters, loadState, parseIsoToEpochMs, parseSince, planUpload, redactSpans, resolveAdapter, runCommand, runExternalAnalyzers, runPipelines, saveState, scanSessions, selectAdapters, serializeSpans, sessionHash, span, toCanonicalOpenInference, toRuntimeStore, toTraceSpanEvents, uploadKey, userPromptSpan, watchSessions, writeOtlpFile };
+export { ATTR, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, CODING_REDACTION_RULES, CONTENT_CAP, ClaudeAdapter, CodexAdapter, type CollectOptions, CopilotAdapter, DEFAULT_HARNESS, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, QwenAdapter, type Redactor, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, type UploadBackend, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, alreadyUploaded, analyzeSpans, applyRedactor, capText, collectSessions, commandAnalyzer, commandRedactor, executeUpload, haloAnalyzer, knownHarnesses, listAdapters, loadState, parseIsoToEpochMs, parseSince, planUpload, redactSpans, resolveAdapter, runCommand, runExternalAnalyzers, runPipelines, saveState, scanSessions, selectAdapters, serializeSpans, sessionHash, span, toCanonicalOpenInference, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, uploadKey, userPromptSpan, watchSessions, writeOtlpFile };

package/dist/index.js

@@ -41,13 +41,14 @@ import {
   sessionHash,
   span,
   toCanonicalOpenInference,
+  toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
   uploadKey,
   userPromptSpan,
   watchSessions,
   writeOtlpFile
-} from "./chunk-Q56AP2EY.js";
+} from "./chunk-BUD6I3ZJ.js";
 
 // src/collect.ts
 async function collectSessions(opts = {}) {
@@ -123,6 +124,7 @@ export {
   sessionHash,
   span,
   toCanonicalOpenInference,
+  toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
   uploadKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Point it at your coding-agent session traces (Claude Code, Codex, OpenCode, Gemini, Pi, …) and get failure-mode + efficiency findings. CLI + SDK over the @tangle-network/agent-eval analyst suite — observe live sessions, run your own analysts, redact, and upload to the Tangle Intelligence Platform.",
   "type": "module",
   "license": "MIT",