@mastra/clickhouse 1.27.0-alpha.2 → 1.27.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-clickhouse
 description: Documentation for @mastra/clickhouse. Use when working with @mastra/clickhouse APIs, configuration, or implementation.
 metadata:
   package: "@mastra/clickhouse"
-  version: "1.27.0-alpha.2"
+  version: "1.27.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.27.0-alpha.2",
+  "version": "1.27.0",
   "package": "@mastra/clickhouse",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -323,7 +323,8 @@ const JSON_FIELDS = [
 	"output",
 	"error",
 	"scope",
-	"links"
+	"links",
+	"stopReasonContext"
 ];
 const NULLABLE_STRING_FIELDS = ["parentSpanId", "error"];
 function transformRow(row) {
@@ -2738,6 +2739,17 @@ CREATE TABLE IF NOT EXISTS ${TABLE_SPAN_EVENTS} (
   endedAt            DateTime64(3, 'UTC'),
   timeToFirstChunkMs Nullable(Float64),
 
+  -- Native span fields, stored as supplied (NULL when the producer set none)
+  externalParentSpanId Nullable(String),
+  resumedFromSpanId  Nullable(String),
+  model              LowCardinality(Nullable(String)),
+  provider           LowCardinality(Nullable(String)),
+  outcome            LowCardinality(Nullable(String)),
+  stopReason         LowCardinality(Nullable(String)),
+  stopReasonContext  Nullable(String),
+  timeToFirstTokenMs Nullable(Float64),
+  errorCount         Nullable(UInt32),
+
   -- Query-relevant flexible fields
   tags               Array(LowCardinality(String)) DEFAULT [],
   metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),
@@ -2812,6 +2824,17 @@ CREATE TABLE IF NOT EXISTS ${TABLE_TRACE_ROOTS} (
   endedAt            DateTime64(3, 'UTC'),
   timeToFirstChunkMs Nullable(Float64),
 
+  -- Native span fields, stored as supplied (NULL when the producer set none)
+  externalParentSpanId Nullable(String),
+  resumedFromSpanId  Nullable(String),
+  model              LowCardinality(Nullable(String)),
+  provider           LowCardinality(Nullable(String)),
+  outcome            LowCardinality(Nullable(String)),
+  stopReason         LowCardinality(Nullable(String)),
+  stopReasonContext  Nullable(String),
+  timeToFirstTokenMs Nullable(Float64),
+  errorCount         Nullable(UInt32),
+
   -- Query-relevant flexible fields
   tags               Array(LowCardinality(String)) DEFAULT [],
   metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),
@@ -2898,6 +2921,17 @@ CREATE TABLE IF NOT EXISTS ${TABLE_TRACE_BRANCHES} (
   endedAt            DateTime64(3, 'UTC'),
   timeToFirstChunkMs Nullable(Float64),
 
+  -- Native span fields, stored as supplied (NULL when the producer set none)
+  externalParentSpanId Nullable(String),
+  resumedFromSpanId  Nullable(String),
+  model              LowCardinality(Nullable(String)),
+  provider           LowCardinality(Nullable(String)),
+  outcome            LowCardinality(Nullable(String)),
+  stopReason         LowCardinality(Nullable(String)),
+  stopReasonContext  Nullable(String),
+  timeToFirstTokenMs Nullable(Float64),
+  errorCount         Nullable(UInt32),
+
   -- Query-relevant flexible fields
   tags               Array(LowCardinality(String)) DEFAULT [],
   metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),
@@ -3633,6 +3667,25 @@ function buildAllMvDDL(strategy) {
 }
 /** Discovery-specific refreshable MVs — created separately from core MVs. */
 const DISCOVERY_MV_DDL = [DISCOVERY_VALUES_MV_DDL, DISCOVERY_PAIRS_MV_DDL];
+/**
+* Span columns added after the first span tables shipped, with their types.
+* Present on span events, trace roots and trace branches.
+*/
+const ADDED_SPAN_COLUMNS = [
+	["inputPreview", "Nullable(String)"],
+	["outputPreview", "Nullable(String)"],
+	["errorPreview", "Nullable(String)"],
+	["timeToFirstChunkMs", "Nullable(Float64)"],
+	["externalParentSpanId", "Nullable(String)"],
+	["resumedFromSpanId", "Nullable(String)"],
+	["model", "LowCardinality(Nullable(String))"],
+	["provider", "LowCardinality(Nullable(String))"],
+	["outcome", "LowCardinality(Nullable(String))"],
+	["stopReason", "LowCardinality(Nullable(String))"],
+	["stopReasonContext", "Nullable(String)"],
+	["timeToFirstTokenMs", "Nullable(Float64)"],
+	["errorCount", "Nullable(UInt32)"]
+];
 const addColumn = (table, name, type) => ({
 	kind: "column",
 	table,
@@ -3657,14 +3710,11 @@ const LOG_SKIP_INDEX_COLUMNS = [
 	"requestId"
 ];
 const ALL_MIGRATIONS = [
-	...[
-		"inputPreview",
-		"outputPreview",
-		"errorPreview"
-	].flatMap((column) => [addColumn(TABLE_TRACE_ROOTS, column, "Nullable(String)"), addColumn(TABLE_TRACE_BRANCHES, column, "Nullable(String)")]),
-	addColumn(TABLE_SPAN_EVENTS, "inputPreview", "Nullable(String)"),
-	addColumn(TABLE_SPAN_EVENTS, "outputPreview", "Nullable(String)"),
-	addColumn(TABLE_SPAN_EVENTS, "errorPreview", "Nullable(String)"),
+	...ADDED_SPAN_COLUMNS.flatMap(([column, type]) => [
+		addColumn(TABLE_TRACE_ROOTS, column, type),
+		addColumn(TABLE_TRACE_BRANCHES, column, type),
+		addColumn(TABLE_SPAN_EVENTS, column, type)
+	]),
 	addColumn(TABLE_TRACE_BRANCHES, "entityVersionId", "Nullable(String)"),
 	addColumn(TABLE_TRACE_BRANCHES, "parentEntityVersionId", "Nullable(String)"),
 	addColumn(TABLE_TRACE_BRANCHES, "rootEntityVersionId", "Nullable(String)"),
@@ -3705,10 +3755,7 @@ const ALL_MIGRATIONS = [
 	addBloomIndex(TABLE_METRIC_EVENTS, "idx_sessionId", "sessionId"),
 	addBloomIndex(TABLE_METRIC_EVENTS, "idx_requestId", "requestId"),
 	...LOG_SKIP_INDEX_COLUMNS.map((column) => addBloomIndex(TABLE_LOG_EVENTS, `idx_${column}`, column)),
-	addBloomIndex(TABLE_DELETION_REQUESTS, "idx_predicateValues", "predicateValues"),
-	addColumn(TABLE_TRACE_ROOTS, "timeToFirstChunkMs", "Nullable(Float64)"),
-	addColumn(TABLE_TRACE_BRANCHES, "timeToFirstChunkMs", "Nullable(Float64)"),
-	addColumn(TABLE_SPAN_EVENTS, "timeToFirstChunkMs", "Nullable(Float64)")
+	addBloomIndex(TABLE_DELETION_REQUESTS, "idx_predicateValues", "predicateValues")
 ];
 const ALL_TABLE_NAMES = [
 	TABLE_SPAN_EVENTS,
@@ -3959,6 +4006,11 @@ const PROMOTED_KEYS = /* @__PURE__ */ new Set([
 	"executionSource",
 	"serviceName"
 ]);
+function nullableNumber$1(value) {
+	if (value == null || value === "") return null;
+	const n = Number(value);
+	return Number.isNaN(n) ? null : n;
+}
 function nullableString(value) {
 	return typeof value === "string" ? value === "" ? null : value : value == null ? null : String(value);
 }
@@ -4040,6 +4092,7 @@ function rowToSpanRecord(row) {
 	const startedAt = toDate(row.startedAt);
 	const endedAt = row.isEvent ? startedAt : toDateOrNull(row.endedAt);
 	const error = parseJson(row.error);
+	const attributes = parseJson(row.attributes);
 	return {
 		traceId: row.traceId,
 		spanId: row.spanId,
@@ -4075,12 +4128,21 @@ function rowToSpanRecord(row) {
 		tags: normalizeTags(row.tags),
 		metadata: parseJson(row.metadataRaw) ?? void 0,
 		scope: parseJson(row.scope) ?? void 0,
-		attributes: parseJson(row.attributes) ?? void 0,
+		attributes: attributes ?? void 0,
 		links: parseJson(row.links) ?? void 0,
 		input: parseJson(row.input) ?? void 0,
 		output: parseJson(row.output) ?? void 0,
 		error: error ?? void 0,
 		requestContext: parseJson(row.requestContext) ?? void 0,
+		externalParentSpanId: nullableString(row.externalParentSpanId),
+		resumedFromSpanId: nullableString(row.resumedFromSpanId),
+		model: nullableString(row.model) ?? (0, _mastra_core_storage.getStringAttribute)(attributes, "model"),
+		provider: nullableString(row.provider) ?? (0, _mastra_core_storage.getStringAttribute)(attributes, "provider"),
+		outcome: nullableString(row.outcome),
+		stopReason: nullableString(row.stopReason),
+		stopReasonContext: parseJson(row.stopReasonContext) ?? null,
+		timeToFirstTokenMs: nullableNumber$1(row.timeToFirstTokenMs),
+		errorCount: nullableNumber$1(row.errorCount),
 		createdAt: startedAt,
 		updatedAt: null
 	};
@@ -4154,6 +4216,15 @@ function spanRecordToRow(span) {
 		startedAt: toISOString(span.startedAt),
 		endedAt: toISOString(endedAt),
 		timeToFirstChunkMs: span.timeToFirstChunkMs ?? null,
+		externalParentSpanId: span.externalParentSpanId ?? null,
+		resumedFromSpanId: span.resumedFromSpanId ?? null,
+		model: span.model ?? null,
+		provider: span.provider ?? null,
+		outcome: span.outcome ?? null,
+		stopReason: span.stopReason ?? null,
+		stopReasonContext: jsonEncode(span.stopReasonContext),
+		timeToFirstTokenMs: span.timeToFirstTokenMs ?? null,
+		errorCount: span.errorCount ?? null,
 		tags: normalizeTags(span.tags),
 		metadataSearch: buildMetadataSearch(metadata),
 		metadataRaw: jsonEncode(metadata),