@breadcrumb-sdk/core 0.0.2 → 0.0.3

package/README.md

@@ -130,10 +130,24 @@ span.set({
 
 All fields are optional. `null` and `undefined` are ignored.
 
+For `input`, passing a `Message[]` array renders the conversation with role labels in the UI — the same way AI SDK spans appear:
+
+```ts
+import type { Message } from "@breadcrumb-sdk/core";
+
+span.set({
+  input: [
+    { role: "system", content: "You are a helpful assistant." },
+    { role: "user", content: "What is TypeScript?" },
+  ] satisfies Message[],
+  output: "TypeScript is a typed superset of JavaScript.",
+});
+```
+
 | Field | Type | Description |
 |-------|------|-------------|
-| `input` | `unknown` | Input passed to this step |
-| `output` | `unknown` | Output produced by this step |
+| `input` | `string \| Message[] \| object` | Input passed to this step |
+| `output` | `string \| object` | Output produced by this step |
 | `model` | `string` | Model name, e.g. `"gpt-4o"` |
 | `provider` | `string` | Provider, e.g. `"openai"` |
 | `input_tokens` | `number` | Input token count |
@@ -141,3 +155,7 @@ All fields are optional. `null` and `undefined` are ignored.
 | `input_cost_usd` | `number` | Input cost in USD |
 | `output_cost_usd` | `number` | Output cost in USD |
 | `metadata` | `Record<string, string \| number \| boolean>` | Any extra data |
+
+## License
+
+AGPL-3.0 — see [LICENSE](./LICENSE) for details.

package/dist/index.cjs

@@ -27,7 +27,38 @@ const __opentelemetry_sdk_trace_node = __toESM(require("@opentelemetry/sdk-trace
 const __opentelemetry_sdk_trace_base = __toESM(require("@opentelemetry/sdk-trace-base"));
 const __opentelemetry_core = __toESM(require("@opentelemetry/core"));
 
-//#region src/exporter.ts
+//#region src/mappers/utils.ts
+function tryJson(s) {
+	try {
+		return JSON.parse(s);
+	} catch {
+		return void 0;
+	}
+}
+function strAttr(attrs, ...keys) {
+	for (const key of keys) {
+		const v = attrs[key];
+		if (typeof v === "string" && v !== "") return v;
+	}
+	return void 0;
+}
+function intAttr(attrs, ...keys) {
+	for (const key of keys) {
+		const v = attrs[key];
+		if (typeof v === "number") return Math.round(v);
+	}
+	return void 0;
+}
+function floatAttr(attrs, ...keys) {
+	for (const key of keys) {
+		const v = attrs[key];
+		if (typeof v === "number") return v;
+	}
+	return void 0;
+}
+
+//#endregion
+//#region src/mappers/ai-sdk.ts
 const LLM_SPAN_NAMES = new Set([
 	"ai.generateText",
 	"ai.generateText.doGenerate",
@@ -42,18 +73,15 @@ const TOOL_SPAN_NAMES = new Set([
 	"ai.toolExecution",
 	"ai.executeToolCall"
 ]);
-const HANDLED_ATTRS = new Set([
-	"breadcrumb.span.type",
-	"breadcrumb.input",
-	"breadcrumb.output",
-	"breadcrumb.model",
-	"breadcrumb.provider",
-	"breadcrumb.input_tokens",
-	"breadcrumb.output_tokens",
-	"breadcrumb.input_cost_usd",
-	"breadcrumb.output_cost_usd",
+const HANDLED = new Set([
+	"resource.name",
+	"ai.prompt",
 	"ai.prompt.messages",
 	"ai.response.text",
+	"ai.response.toolCalls",
+	"ai.toolCall.name",
+	"ai.toolCall.args",
+	"ai.toolCall.result",
 	"ai.model.id",
 	"ai.model.provider",
 	"ai.response.model",
@@ -68,61 +96,25 @@ const HANDLED_ATTRS = new Set([
 	"ai.response.providerMetadata",
 	"ai.response.finishReason"
 ]);
-const DROP_ATTRS = new Set([
+const DROP = new Set([
 	"operation.name",
-	"resource.name",
 	"ai.operationId",
 	"ai.telemetry.functionId",
 	"gen_ai.response.finish_reasons",
 	"gen_ai.response.id",
 	"gen_ai.response.model",
 	"ai.response.id",
-	"ai.response.timestamp"
+	"ai.response.timestamp",
+	"ai.prompt.tools",
+	"ai.prompt.toolChoice",
+	"ai.toolCall.id"
 ]);
-function hrTimeToISO(hrTime) {
-	return new Date(hrTime[0] * 1e3 + hrTime[1] / 1e6).toISOString();
-}
-function spanStatus(span) {
-	return span.status.code === __opentelemetry_api.SpanStatusCode.ERROR ? "error" : "ok";
-}
-function strAttr(span, ...keys) {
-	for (const key of keys) {
-		const v = span.attributes[key];
-		if (typeof v === "string" && v !== "") return v;
-	}
-	return void 0;
-}
-function intAttr(span, ...keys) {
-	for (const key of keys) {
-		const v = span.attributes[key];
-		if (typeof v === "number") return Math.round(v);
-	}
-	return void 0;
-}
-function floatAttr(span, ...keys) {
-	for (const key of keys) {
-		const v = span.attributes[key];
-		if (typeof v === "number") return v;
-	}
-	return void 0;
-}
-function tryJson(s) {
-	try {
-		return JSON.parse(s);
-	} catch {
-		return void 0;
-	}
-}
-function inferSpanType(span) {
-	const explicit = span.attributes["breadcrumb.span.type"];
-	if (typeof explicit === "string" && explicit !== "") return explicit;
-	if (LLM_SPAN_NAMES.has(span.name)) return "llm";
-	if (TOOL_SPAN_NAMES.has(span.name)) return "tool";
+function inferType(spanName) {
+	if (LLM_SPAN_NAMES.has(spanName)) return "llm";
+	if (TOOL_SPAN_NAMES.has(spanName)) return "tool";
 	return "custom";
 }
-function extractCost(span) {
-	const raw = span.attributes["ai.response.providerMetadata"];
-	if (typeof raw !== "string") return {};
+function extractCost(raw) {
 	try {
 		const parsed = tryJson(raw);
 		if (!parsed || typeof parsed !== "object") return {};
@@ -143,6 +135,159 @@ function extractCost(span) {
 	} catch {}
 	return {};
 }
+function mapAiSdk(span) {
+	const attrs = span.attributes;
+	const result = {};
+	const toolCallName = strAttr(attrs, "ai.toolCall.name");
+	const resourceName = strAttr(attrs, "resource.name");
+	if (toolCallName) result.name = toolCallName;
+	else if (resourceName) result.name = resourceName;
+	result.type = inferType(span.name);
+	const toolArgs = attrs["ai.toolCall.args"];
+	const aiMessages = attrs["ai.prompt.messages"];
+	const aiPrompt = attrs["ai.prompt"];
+	if (typeof toolArgs === "string") result.input = tryJson(toolArgs) ?? toolArgs;
+	else if (typeof aiMessages === "string") result.input = tryJson(aiMessages) ?? aiMessages;
+	else if (typeof aiPrompt === "string") {
+		const parsed = tryJson(aiPrompt);
+		if (parsed && typeof parsed === "object") {
+			const messages = [];
+			if (parsed["system"]) messages.push({
+				role: "system",
+				content: parsed["system"]
+			});
+			if (Array.isArray(parsed["messages"])) messages.push(...parsed["messages"]);
+			else if (parsed["prompt"] !== void 0) messages.push({
+				role: "user",
+				content: parsed["prompt"]
+			});
+			result.input = messages.length > 0 ? messages : parsed;
+		} else result.input = aiPrompt;
+	}
+	const toolResult = attrs["ai.toolCall.result"];
+	const aiText = attrs["ai.response.text"];
+	const aiToolCalls = attrs["ai.response.toolCalls"];
+	if (typeof toolResult === "string") result.output = tryJson(toolResult) ?? toolResult;
+	else if (typeof aiText === "string") result.output = aiText;
+	else if (typeof aiToolCalls === "string") {
+		const parsed = tryJson(aiToolCalls);
+		if (Array.isArray(parsed)) result.output = parsed.map((tc) => ({
+			...tc,
+			input: typeof tc["input"] === "string" ? tryJson(tc["input"]) ?? tc["input"] : tc["input"]
+		}));
+		else result.output = parsed ?? aiToolCalls;
+	}
+	const model = strAttr(attrs, "ai.model.id", "ai.response.model", "gen_ai.request.model");
+	if (model) result.model = model;
+	const provider = strAttr(attrs, "ai.model.provider", "gen_ai.system");
+	if (provider) result.provider = provider;
+	const input_tokens = intAttr(attrs, "ai.usage.inputTokens", "ai.usage.promptTokens", "gen_ai.usage.input_tokens");
+	if (input_tokens != null) result.input_tokens = input_tokens;
+	const output_tokens = intAttr(attrs, "ai.usage.outputTokens", "ai.usage.completionTokens", "gen_ai.usage.output_tokens");
+	if (output_tokens != null) result.output_tokens = output_tokens;
+	const providerMeta = attrs["ai.response.providerMetadata"];
+	if (typeof providerMeta === "string") {
+		const cost = extractCost(providerMeta);
+		if (cost.input_cost_usd != null) result.input_cost_usd = cost.input_cost_usd;
+		if (cost.output_cost_usd != null) result.output_cost_usd = cost.output_cost_usd;
+	}
+	const metadata = {};
+	const finishReason = attrs["ai.response.finishReason"];
+	if (typeof finishReason === "string" && finishReason !== "") metadata["finish_reason"] = finishReason;
+	for (const [k, v] of Object.entries(attrs)) {
+		if (v == null) continue;
+		if (HANDLED.has(k) || DROP.has(k)) continue;
+		if (k.startsWith("ai.settings.") || k.startsWith("ai.request.headers.")) continue;
+		if (k.startsWith("ai.telemetry.metadata.")) {
+			metadata[k.slice(22)] = String(v);
+			continue;
+		}
+		if (k.startsWith("ai.") || k.startsWith("gen_ai.")) metadata[k] = String(v);
+	}
+	if (Object.keys(metadata).length > 0) result.metadata = metadata;
+	return result;
+}
+
+//#endregion
+//#region src/mappers/breadcrumb.ts
+const VALID_TYPES = new Set([
+	"llm",
+	"tool",
+	"retrieval",
+	"step",
+	"custom"
+]);
+function mapBreadcrumb(span) {
+	const attrs = span.attributes;
+	const result = {};
+	const explicitType = attrs["breadcrumb.span.type"];
+	if (typeof explicitType === "string" && VALID_TYPES.has(explicitType)) result.type = explicitType;
+	const rawInput = attrs["breadcrumb.input"];
+	if (rawInput != null) result.input = typeof rawInput === "string" ? tryJson(rawInput) ?? rawInput : rawInput;
+	const rawOutput = attrs["breadcrumb.output"];
+	if (rawOutput != null) result.output = typeof rawOutput === "string" ? tryJson(rawOutput) ?? rawOutput : rawOutput;
+	const model = strAttr(attrs, "breadcrumb.model");
+	if (model) result.model = model;
+	const provider = strAttr(attrs, "breadcrumb.provider");
+	if (provider) result.provider = provider;
+	const input_tokens = intAttr(attrs, "breadcrumb.input_tokens");
+	if (input_tokens != null) result.input_tokens = input_tokens;
+	const output_tokens = intAttr(attrs, "breadcrumb.output_tokens");
+	if (output_tokens != null) result.output_tokens = output_tokens;
+	const input_cost_usd = floatAttr(attrs, "breadcrumb.input_cost_usd");
+	if (input_cost_usd != null) result.input_cost_usd = input_cost_usd;
+	const output_cost_usd = floatAttr(attrs, "breadcrumb.output_cost_usd");
+	if (output_cost_usd != null) result.output_cost_usd = output_cost_usd;
+	const metadata = {};
+	for (const [k, v] of Object.entries(attrs)) {
+		if (v == null) continue;
+		if (k.startsWith("breadcrumb.meta.")) metadata[k.slice(16)] = String(v);
+	}
+	if (Object.keys(metadata).length > 0) result.metadata = metadata;
+	return result;
+}
+
+//#endregion
+//#region src/exporter.ts
+const MAPPER_NAMESPACES = [
+	"ai.",
+	"gen_ai.",
+	"breadcrumb.",
+	"resource.name"
+];
+const GLOBAL_DROP = new Set(["operation.name"]);
+function hrTimeToISO(hrTime) {
+	return new Date(hrTime[0] * 1e3 + hrTime[1] / 1e6).toISOString();
+}
+function spanStatus(span) {
+	return span.status.code === __opentelemetry_api.SpanStatusCode.ERROR ? "error" : "ok";
+}
+function mergeMappers(span) {
+	const aiSdk = mapAiSdk(span);
+	const bc = mapBreadcrumb(span);
+	return {
+		...aiSdk,
+		...bc,
+		metadata: aiSdk.metadata || bc.metadata ? {
+			...aiSdk.metadata,
+			...bc.metadata
+		} : void 0
+	};
+}
+function passthroughMetadata(span, existing) {
+	const extra = {};
+	for (const [k, v] of Object.entries(span.attributes)) {
+		if (v == null) continue;
+		const handled = MAPPER_NAMESPACES.some((ns) => k === ns || k.startsWith(ns));
+		if (handled || GLOBAL_DROP.has(k)) continue;
+		extra[k] = String(v);
+	}
+	if (Object.keys(extra).length === 0) return existing || void 0;
+	return {
+		...extra,
+		...existing
+	};
+}
 var BreadcrumbSpanExporter = class {
 	constructor(apiKey, baseUrl) {
 		this.apiKey = apiKey;
@@ -162,74 +307,35 @@ var BreadcrumbSpanExporter = class {
 	}
 	_mapSpan(span) {
 		const ctx = span.spanContext();
-		const attrs = span.attributes;
-		let input;
-		const bcInput = attrs["breadcrumb.input"];
-		const aiMessages = attrs["ai.prompt.messages"];
-		if (bcInput != null) input = typeof bcInput === "string" ? tryJson(bcInput) ?? bcInput : bcInput;
-		else if (typeof aiMessages === "string") input = tryJson(aiMessages) ?? aiMessages;
-		let output;
-		const bcOutput = attrs["breadcrumb.output"];
-		const aiText = attrs["ai.response.text"];
-		if (bcOutput != null) output = typeof bcOutput === "string" ? tryJson(bcOutput) ?? bcOutput : bcOutput;
-		else if (typeof aiText === "string") output = aiText;
-		const model = strAttr(span, "breadcrumb.model", "ai.model.id", "ai.response.model", "gen_ai.request.model");
-		const provider = strAttr(span, "breadcrumb.provider", "ai.model.provider", "gen_ai.system");
-		const input_tokens = intAttr(span, "breadcrumb.input_tokens", "ai.usage.inputTokens", "ai.usage.promptTokens", "gen_ai.usage.input_tokens");
-		const output_tokens = intAttr(span, "breadcrumb.output_tokens", "ai.usage.outputTokens", "ai.usage.completionTokens", "gen_ai.usage.output_tokens");
-		let input_cost_usd = floatAttr(span, "breadcrumb.input_cost_usd");
-		let output_cost_usd = floatAttr(span, "breadcrumb.output_cost_usd");
-		if (input_cost_usd == null && output_cost_usd == null) {
-			const cost = extractCost(span);
-			input_cost_usd = cost.input_cost_usd;
-			output_cost_usd = cost.output_cost_usd;
-		}
-		const metadata = {};
-		for (const [k, v] of Object.entries(attrs)) {
-			if (v == null) continue;
-			if (HANDLED_ATTRS.has(k) || DROP_ATTRS.has(k)) continue;
-			if (k.startsWith("ai.settings.")) continue;
-			if (k.startsWith("ai.request.headers.")) continue;
-			if (k.startsWith("breadcrumb.")) {
-				if (k.startsWith("breadcrumb.meta.")) metadata[k.slice(16)] = String(v);
-				continue;
-			}
-			if (k.startsWith("ai.telemetry.metadata.")) {
-				metadata[k.slice(22)] = String(v);
-				continue;
-			}
-			if (k === "ai.response.finishReason") {
-				metadata["finish_reason"] = String(v);
-				continue;
-			}
-			metadata[k] = String(v);
-		}
+		const mapped = mergeMappers(span);
+		const metadata = passthroughMetadata(span, mapped.metadata);
 		return {
 			id: ctx.spanId,
 			trace_id: ctx.traceId,
 			parent_span_id: span.parentSpanId || void 0,
-			name: span.name,
-			type: inferSpanType(span),
+			name: mapped.name ?? span.name,
+			type: mapped.type ?? "custom",
 			start_time: hrTimeToISO(span.startTime),
 			end_time: hrTimeToISO(span.endTime),
 			status: spanStatus(span),
 			status_message: span.status.message || void 0,
-			input: input !== void 0 ? input : void 0,
-			output: output !== void 0 ? output : void 0,
-			provider,
-			model,
-			input_tokens,
-			output_tokens,
-			input_cost_usd,
-			output_cost_usd,
-			metadata: Object.keys(metadata).length > 0 ? metadata : void 0
+			input: mapped.input !== void 0 ? mapped.input : void 0,
+			output: mapped.output !== void 0 ? mapped.output : void 0,
+			provider: mapped.provider,
+			model: mapped.model,
+			input_tokens: mapped.input_tokens,
+			output_tokens: mapped.output_tokens,
+			input_cost_usd: mapped.input_cost_usd,
+			output_cost_usd: mapped.output_cost_usd,
+			metadata: metadata && Object.keys(metadata).length > 0 ? metadata : void 0
 		};
 	}
 	async _sendTrace(span) {
 		const ctx = span.spanContext();
+		const mapped = mergeMappers(span);
 		await this._post("/v1/traces", {
 			id: ctx.traceId,
-			name: span.name,
+			name: mapped.name ?? span.name,
 			start_time: hrTimeToISO(span.startTime),
 			end_time: hrTimeToISO(span.endTime),
 			status: spanStatus(span),

package/dist/index.d.cts

@@ -1,7 +1,25 @@
 //#region src/types.d.ts
+/**
+ * A single message in a conversation. Pass an array of these as `input` to
+ * display the conversation in the Breadcrumb UI the same way LLM spans appear.
+ */
+interface Message {
+  role: "system" | "user" | "assistant" | "tool";
+  content: string;
+}
 interface SpanData {
-  input?: unknown;
-  output?: unknown;
+  /**
+   * The input to this step. Use a plain string for simple inputs, or a
+   * `Message[]` array for conversation-style inputs — the UI renders both
+   * with role labels (system / user / assistant).
+   * Any other JSON-serializable value is also accepted and shown as raw data.
+   */
+  input?: string | Message[] | Record<string, unknown>;
+  /**
+   * The output from this step. Use a plain string for text outputs.
+   * Any JSON-serializable value is accepted.
+   */
+  output?: string | Record<string, unknown>;
   model?: string;
   provider?: string;
   input_tokens?: number;
@@ -21,6 +39,7 @@ interface Breadcrumb {
   span<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>, options?: SpanOptions): Promise<T>;
 } //#endregion
 //#region src/index.d.ts
+
 //# sourceMappingURL=types.d.ts.map
 interface InitOptions {
   apiKey: string;
@@ -35,5 +54,5 @@ declare function init(options: InitOptions): Breadcrumb;
 //#endregion
 //# sourceMappingURL=index.d.ts.map
 
-export { Breadcrumb, BreadcrumbSpan, InitOptions, SpanOptions, init };
+export { Breadcrumb, BreadcrumbSpan, InitOptions, Message, SpanData, SpanOptions, init };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";UAAiB,QAAA;EAAA,KAAA,CAAA,EAAA,OAAQ;EAYR,MAAA,CAAA,EAAA,OAAA;EAIA,KAAA,CAAA,EAAA,MAAW;EAIX,QAAA,CAAA,EAAA,MAAU;EAAA,YAAA,CAAA,EAAA,MAAA;EAAA,aACS,CAAA,EAAA,MAAA;EAAc,cAAa,CAAA,EAAA,MAAA;EAAC,eAAT,CAAA,EAAA,MAAA;EAAO,QAAc,CAAA,EAZ/D,MAY+D,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;;AAG7D,UAZE,cAAA,CAYF;EAAc,GAAa,CAAA,IAAA,EAX9B,QAW8B,CAAA,EAAA,IAAA;;AAC5B,UATG,WAAA,CASH;EAAW,IACZ,CAAA,EAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAD,UANK,UAAA,CAML;oCALwB,mBAAmB,QAAQ,KAAK,QAAQ;mCAG7D,mBAAmB,QAAQ,cAC5B,cACT,QAAQ;;;ACTb;ADLiB,UCKA,WAAA,CDLc;EAId,MAAA,EAAA,MAAW;EAIX,OAAA,EAAA,MAAU;EAAA,QAAA,CAAA,EAAA,KAAA,GAAA;IACS,aAAA,CAAA,EAAA,MAAA;IAA2B,YAAA,CAAA,EAAA,MAAA;EAAC,CAAA;;AAAI,iBCOpD,IAAA,CDPoD,OAAA,ECOtC,WDPsC,CAAA,ECOxB,UDPwB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";;;;;UAIiB,OAAA;EAAA,IAAA,EAAA,QAAO,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;EAKP,OAAA,EAAA,MAAQ;;AAON,UAPF,QAAA,CAOE;EAAO;;;AAYP;AAGnB;AAIA;EAIiB,KAAA,CAAA,EAAA,MAAU,GAvBR,OAuBQ,EAAA,GAvBI,MAuBJ,CAAA,MAAA,EAAA,OAAA,CAAA;EAAA;;;;EACmC,MAAc,CAAA,EAAA,MAAA,GAnBxD,MAmBwD,CAAA,MAAA,EAAA,OAAA,CAAA;EAAC,KAAT,CAAA,EAAA,MAAA;EAAO,QAG5D,CAAA,EAAA,MAAA;EAAc,YAAa,CAAA,EAAA,MAAA;EAAC,aAAT,CAAA,EAAA,MAAA;EAAO,cAC3B,CAAA,EAAA,MAAA;EAAW,eACZ,CAAA,EAAA,MAAA;EAAC,QAAT,CAAA,EAjBQ,MAiBR,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;AAAO;UAdK,cAAA;YACL;;ACfK,UDkBA,WAAA,CClBW;EAWZ,IAAA,CAAA,EAAI,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAU,UDWb,UAAA,CCXa;EAAW,KAAG,CAAA,CAAA,CAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,CAAA,IAAA,EDYR,cCZQ,EAAA,GDYW,OCZX,CDYmB,CCZnB,CAAA,CAAA,EDYwB,OCZxB,CDYgC,CCZhC,CAAA;EAAU,IAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,CAAA,IAAA,EDevC,cCfuC,EAAA,GDepB,OCfoB,CDeZ,CCfY,CAAA,EAAA,OAAA,CAAA,EDgBxC,WChBwC,CAAA,EDiBjD,OCjBiD,CDiBzC,CCjByC,CAAA;;;;;UAXrC,WAAA;;;EDbA,QAAA,CAAA,EAAO,KAAA,GAAA;IAKP,aAAQ,CAAA,EAAA,MAAA;IAAA,YAAA,CAAA,EAAA,MAAA;EAAA,CAAA;;AAYL,iBCOJ,IAAA,CDPI,OAAA,ECOU,WDPV,CAAA,ECOwB,UDPxB"}

package/dist/index.d.ts

@@ -1,7 +1,25 @@
 //#region src/types.d.ts
+/**
+ * A single message in a conversation. Pass an array of these as `input` to
+ * display the conversation in the Breadcrumb UI the same way LLM spans appear.
+ */
+interface Message {
+  role: "system" | "user" | "assistant" | "tool";
+  content: string;
+}
 interface SpanData {
-  input?: unknown;
-  output?: unknown;
+  /**
+   * The input to this step. Use a plain string for simple inputs, or a
+   * `Message[]` array for conversation-style inputs — the UI renders both
+   * with role labels (system / user / assistant).
+   * Any other JSON-serializable value is also accepted and shown as raw data.
+   */
+  input?: string | Message[] | Record<string, unknown>;
+  /**
+   * The output from this step. Use a plain string for text outputs.
+   * Any JSON-serializable value is accepted.
+   */
+  output?: string | Record<string, unknown>;
   model?: string;
   provider?: string;
   input_tokens?: number;
@@ -21,6 +39,7 @@ interface Breadcrumb {
   span<T>(name: string, fn: (span: BreadcrumbSpan) => Promise<T>, options?: SpanOptions): Promise<T>;
 } //#endregion
 //#region src/index.d.ts
+
 //# sourceMappingURL=types.d.ts.map
 interface InitOptions {
   apiKey: string;
@@ -35,5 +54,5 @@ declare function init(options: InitOptions): Breadcrumb;
 //#endregion
 //# sourceMappingURL=index.d.ts.map
 
-export { Breadcrumb, BreadcrumbSpan, InitOptions, SpanOptions, init };
+export { Breadcrumb, BreadcrumbSpan, InitOptions, Message, SpanData, SpanOptions, init };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";UAAiB,QAAA;EAAA,KAAA,CAAA,EAAA,OAAQ;EAYR,MAAA,CAAA,EAAA,OAAA;EAIA,KAAA,CAAA,EAAA,MAAW;EAIX,QAAA,CAAA,EAAA,MAAU;EAAA,YAAA,CAAA,EAAA,MAAA;EAAA,aACS,CAAA,EAAA,MAAA;EAAc,cAAa,CAAA,EAAA,MAAA;EAAC,eAAT,CAAA,EAAA,MAAA;EAAO,QAAc,CAAA,EAZ/D,MAY+D,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;;AAG7D,UAZE,cAAA,CAYF;EAAc,GAAa,CAAA,IAAA,EAX9B,QAW8B,CAAA,EAAA,IAAA;;AAC5B,UATG,WAAA,CASH;EAAW,IACZ,CAAA,EAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAD,UANK,UAAA,CAML;oCALwB,mBAAmB,QAAQ,KAAK,QAAQ;mCAG7D,mBAAmB,QAAQ,cAC5B,cACT,QAAQ;;;ACTb;ADLiB,UCKA,WAAA,CDLc;EAId,MAAA,EAAA,MAAW;EAIX,OAAA,EAAA,MAAU;EAAA,QAAA,CAAA,EAAA,KAAA,GAAA;IACS,aAAA,CAAA,EAAA,MAAA;IAA2B,YAAA,CAAA,EAAA,MAAA;EAAC,CAAA;;AAAI,iBCOpD,IAAA,CDPoD,OAAA,ECOtC,WDPsC,CAAA,ECOxB,UDPwB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":null,"mappings":";;;;;UAIiB,OAAA;EAAA,IAAA,EAAA,QAAO,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;EAKP,OAAA,EAAA,MAAQ;;AAON,UAPF,QAAA,CAOE;EAAO;;;AAYP;AAGnB;AAIA;EAIiB,KAAA,CAAA,EAAA,MAAU,GAvBR,OAuBQ,EAAA,GAvBI,MAuBJ,CAAA,MAAA,EAAA,OAAA,CAAA;EAAA;;;;EACmC,MAAc,CAAA,EAAA,MAAA,GAnBxD,MAmBwD,CAAA,MAAA,EAAA,OAAA,CAAA;EAAC,KAAT,CAAA,EAAA,MAAA;EAAO,QAG5D,CAAA,EAAA,MAAA;EAAc,YAAa,CAAA,EAAA,MAAA;EAAC,aAAT,CAAA,EAAA,MAAA;EAAO,cAC3B,CAAA,EAAA,MAAA;EAAW,eACZ,CAAA,EAAA,MAAA;EAAC,QAAT,CAAA,EAjBQ,MAiBR,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA;AAAO;UAdK,cAAA;YACL;;ACfK,UDkBA,WAAA,CClBW;EAWZ,IAAA,CAAA,EAAI,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA;;AAAU,UDWb,UAAA,CCXa;EAAW,KAAG,CAAA,CAAA,CAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,CAAA,IAAA,EDYR,cCZQ,EAAA,GDYW,OCZX,CDYmB,CCZnB,CAAA,CAAA,EDYwB,OCZxB,CDYgC,CCZhC,CAAA;EAAU,IAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EAAA,MAAA,EAAA,EAAA,EAAA,CAAA,IAAA,EDevC,cCfuC,EAAA,GDepB,OCfoB,CDeZ,CCfY,CAAA,EAAA,OAAA,CAAA,EDgBxC,WChBwC,CAAA,EDiBjD,OCjBiD,CDiBzC,CCjByC,CAAA;;;;;UAXrC,WAAA;;;EDbA,QAAA,CAAA,EAAO,KAAA,GAAA;IAKP,aAAQ,CAAA,EAAA,MAAA;IAAA,YAAA,CAAA,EAAA,MAAA;EAAA,CAAA;;AAYL,iBCOJ,IAAA,CDPI,OAAA,ECOU,WDPV,CAAA,ECOwB,UDPxB"}