@mastra/clickhouse 1.6.0 → 1.7.0

package/dist/storage/db/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/storage/db/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA+BtF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAkCrD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAS9D,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE;SACH,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAE;YAC1B,GAAG,CAAC,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,YAAY,CAAC;gBAAC,MAAM,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAChE,OAAO,CAAC,EAAE,OAAO,CAAC;iBACf,SAAS,IAAI,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG;oBACrD,QAAQ,EAAE,MAAM,CAAC;oBACjB,IAAI,EAAE,YAAY,CAAC;oBACnB,MAAM,CAAC,EAAE,MAAM,CAAC;iBACjB;aACF,CAAC,CAAC;SACJ;KACF,CAAC;CACH,CAAC;AAQF,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,CAiC3C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAEjD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/storage/db/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAiCtF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAoCrD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAS9D,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE;SACH,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAE;YAC1B,GAAG,CAAC,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,YAAY,CAAC;gBAAC,MAAM,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAChE,OAAO,CAAC,EAAE,OAAO,CAAC;iBACf,SAAS,IAAI,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG;oBACrD,QAAQ,EAAE,MAAM,CAAC;oBACjB,IAAI,EAAE,YAAY,CAAC;oBACnB,MAAM,CAAC,EAAE,MAAM,CAAC;iBACjB;aACF,CAAC,CAAC;SACJ;KACF,CAAC;CACH,CAAC;AAQF,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,CAiC3C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAEjD"}

package/dist/storage/domains/observability/v-next/ddl.d.ts

@@ -21,6 +21,7 @@
  */
 export declare const TABLE_SPAN_EVENTS = "mastra_span_events";
 export declare const TABLE_TRACE_ROOTS = "mastra_trace_roots";
+export declare const TABLE_TRACE_BRANCHES = "mastra_trace_branches";
 export declare const TABLE_METRIC_EVENTS = "mastra_metric_events";
 export declare const TABLE_LOG_EVENTS = "mastra_log_events";
 export declare const TABLE_SCORE_EVENTS = "mastra_score_events";
@@ -28,12 +29,25 @@ export declare const TABLE_FEEDBACK_EVENTS = "mastra_feedback_events";
 export declare const TABLE_DISCOVERY_VALUES = "mastra_discovery_values";
 export declare const TABLE_DISCOVERY_PAIRS = "mastra_discovery_pairs";
 export declare const MV_TRACE_ROOTS = "mastra_mv_trace_roots";
+export declare const MV_TRACE_BRANCHES = "mastra_mv_trace_branches";
 export declare const MV_DISCOVERY_VALUES = "mastra_mv_discovery_values";
 export declare const MV_DISCOVERY_PAIRS = "mastra_mv_discovery_pairs";
+/**
+ * Span types that anchor a listable trace branch -- a named entity got
+ * invoked. Materialized into `mastra_trace_branches` so they're listable
+ * independently of where they appear in a trace tree.
+ *
+ * Kept as a literal SQL list (not derived from {@link BRANCH_SPAN_TYPES})
+ * so the MV definition is hermetic and doesn't trigger re-creation if a
+ * future enum re-order changes the value source.
+ */
+export declare const BRANCH_SPAN_TYPE_VALUES: readonly ["agent_run", "workflow_run", "processor_run", "scorer_run", "rag_ingestion", "tool_call", "mcp_tool_call"];
 export declare const SPAN_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_span_events (\n  -- Identity\n  dedupeKey          String,\n\n  -- IDs\n  traceId            String,\n  spanId             String,\n  parentSpanId       Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n\n  -- Parent entity\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n\n  -- Root entity\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Span scalars\n  name               String,\n  spanType           LowCardinality(String),\n  isEvent            Bool DEFAULT false,\n  startedAt          DateTime64(3, 'UTC'),\n  endedAt            DateTime64(3, 'UTC'),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n  metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),\n\n  -- Information-only JSON payloads\n  attributes         Nullable(String),\n  scope              Nullable(String),\n  links              Nullable(String),\n  input              Nullable(String),\n  output             Nullable(String),\n  error              Nullable(String),\n  metadataRaw        Nullable(String),\n  requestContext     Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(endedAt)\nORDER BY (traceId, endedAt, spanId, dedupeKey)\n";
 export declare const TRACE_ROOTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_trace_roots (\n  -- Identity\n  dedupeKey          String,\n\n  -- IDs\n  traceId            String,\n  spanId             String,\n  parentSpanId       Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n\n  -- Parent entity\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n\n  -- Root entity\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Span scalars\n  name               String,\n  spanType           LowCardinality(String),\n  isEvent            Bool DEFAULT false,\n  startedAt          DateTime64(3, 'UTC'),\n  endedAt            DateTime64(3, 'UTC'),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n  metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),\n\n  -- Information-only JSON payloads\n  attributes         Nullable(String),\n  scope              Nullable(String),\n  links              Nullable(String),\n  input              Nullable(String),\n  output             Nullable(String),\n  error              Nullable(String),\n  metadataRaw        Nullable(String),\n  requestContext     Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(endedAt)\nORDER BY (startedAt, traceId, dedupeKey)\n";
 export declare const TRACE_ROOTS_MV_DDL = "\nCREATE MATERIALIZED VIEW IF NOT EXISTS mastra_mv_trace_roots\nTO mastra_trace_roots\nAS\nSELECT *\nFROM mastra_span_events\nWHERE parentSpanId IS NULL\n";
-export declare const METRIC_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_metric_events (\n  -- Timestamp\n  timestamp          DateTime64(3, 'UTC'),\n\n  -- IDs\n  metricId           String,\n  traceId            Nullable(String),\n  spanId             Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity hierarchy\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Metric scalars\n  name               LowCardinality(String),\n  value              Float64,\n  provider           LowCardinality(Nullable(String)),\n  model              Nullable(String),\n  estimatedCost      Nullable(Float64),\n  costUnit           LowCardinality(Nullable(String)),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n  labels             Map(LowCardinality(String), String) DEFAULT map(),\n\n  -- Information-only JSON payloads\n  costMetadata       Nullable(String),\n  metadata           Nullable(String),\n  scope              Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(timestamp)\nORDER BY (name, timestamp, metricId)\n";
+export declare const TRACE_BRANCHES_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_trace_branches (\n  -- Identity\n  dedupeKey          String,\n\n  -- IDs\n  traceId            String,\n  spanId             String,\n  parentSpanId       Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n\n  -- Parent entity\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n\n  -- Root entity\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Span scalars\n  name               String,\n  spanType           LowCardinality(String),\n  isEvent            Bool DEFAULT false,\n  startedAt          DateTime64(3, 'UTC'),\n  endedAt            DateTime64(3, 'UTC'),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n  metadataSearch     Map(LowCardinality(String), String) DEFAULT map(),\n\n  -- Information-only JSON payloads\n  attributes         Nullable(String),\n  scope              Nullable(String),\n  links              Nullable(String),\n  input              Nullable(String),\n  output             Nullable(String),\n  error              Nullable(String),\n  metadataRaw        Nullable(String),\n  requestContext     Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(endedAt)\nORDER BY (spanType, startedAt, traceId, dedupeKey)\n";
+export declare const TRACE_BRANCHES_MV_DDL: string;
+export declare const METRIC_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_metric_events (\n  -- Timestamp\n  timestamp          DateTime64(3, 'UTC'),\n\n  -- IDs\n  metricId           String,\n  traceId            Nullable(String),\n  spanId             Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity hierarchy\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Metric scalars\n  name               LowCardinality(String),\n  value              Float64,\n  provider           LowCardinality(Nullable(String)),\n  model              Nullable(String),\n  estimatedCost      Nullable(Float64),\n  costUnit           LowCardinality(Nullable(String)),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n  labels             Map(LowCardinality(String), String) DEFAULT map(),\n\n  -- Information-only JSON payloads\n  costMetadata       Nullable(String),\n  metadata           Nullable(String),\n  scope              Nullable(String),\n\n  -- Bloom-filter skip indexes for high-cardinality ID drilldowns.\n  -- Equality and IN filters on these columns can skip granule chunks that\n  -- definitely do not contain the value. GRANULARITY 2 = 16K-row chunks.\n  -- ID columns are out-of-sort-key, so without these every drilldown scans\n  -- every row in the time range.\n  INDEX idx_traceId traceId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_threadId threadId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_resourceId resourceId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_userId userId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_organizationId organizationId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_experimentId experimentId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_runId runId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_sessionId sessionId TYPE bloom_filter(0.01) GRANULARITY 2,\n  INDEX idx_requestId requestId TYPE bloom_filter(0.01) GRANULARITY 2\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(timestamp)\nORDER BY (name, timestamp, metricId)\n";
 export declare const LOG_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_log_events (\n  -- Timestamp\n  timestamp          DateTime64(3, 'UTC'),\n\n  -- IDs\n  logId              String,\n  traceId            Nullable(String),\n  spanId             Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity hierarchy\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Log scalars\n  level              LowCardinality(String),\n  message            String,\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n\n  -- Information-only JSON payloads\n  data               Nullable(String),\n  metadata           Nullable(String),\n  scope              Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(timestamp)\nORDER BY (timestamp, logId)\n";
 export declare const SCORE_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_score_events (\n  -- Timestamp\n  timestamp          DateTime64(3, 'UTC'),\n\n  -- IDs\n  scoreId            String,\n  traceId            Nullable(String),\n  spanId             Nullable(String),\n  experimentId       Nullable(String),\n  scoreTraceId       Nullable(String),\n\n  -- Entity hierarchy\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Scorer identity\n  scorerId           LowCardinality(String),\n  scorerVersion      LowCardinality(Nullable(String)),\n  scoreSource        LowCardinality(Nullable(String)),\n\n  -- Score value\n  score              Float64,\n\n  -- Information-only\n  reason             Nullable(String),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n\n  -- Information-only JSON payloads\n  metadata           Nullable(String),\n  scope              Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(timestamp)\nORDER BY (traceId, timestamp, scoreId)\nSETTINGS allow_nullable_key = 1\n";
 export declare const FEEDBACK_EVENTS_DDL = "\nCREATE TABLE IF NOT EXISTS mastra_feedback_events (\n  -- Timestamp\n  timestamp          DateTime64(3, 'UTC'),\n\n  -- IDs\n  feedbackId         String,\n  traceId            Nullable(String),\n  spanId             Nullable(String),\n  experimentId       Nullable(String),\n\n  -- Entity hierarchy\n  entityType         LowCardinality(Nullable(String)),\n  entityId           Nullable(String),\n  entityName         Nullable(String),\n  entityVersionId    Nullable(String),\n  parentEntityVersionId Nullable(String),\n  parentEntityType   LowCardinality(Nullable(String)),\n  parentEntityId     Nullable(String),\n  parentEntityName   Nullable(String),\n  rootEntityVersionId Nullable(String),\n  rootEntityType     LowCardinality(Nullable(String)),\n  rootEntityId       Nullable(String),\n  rootEntityName     Nullable(String),\n\n  -- Context\n  userId             Nullable(String),\n  organizationId     Nullable(String),\n  resourceId         Nullable(String),\n  runId              Nullable(String),\n  sessionId          Nullable(String),\n  threadId           Nullable(String),\n  requestId          Nullable(String),\n  environment        LowCardinality(Nullable(String)),\n  executionSource    LowCardinality(Nullable(String)),\n  serviceName        LowCardinality(Nullable(String)),\n\n  -- Feedback actor / linkage\n  feedbackUserId     Nullable(String),\n  sourceId           Nullable(String),\n\n  -- Feedback identity\n  feedbackSource     LowCardinality(String),\n  feedbackType       LowCardinality(String),\n\n  -- Feedback value (exactly one non-null per valid row)\n  valueString        Nullable(String),\n  valueNumber        Nullable(Float64),\n\n  -- Information-only\n  comment            Nullable(String),\n\n  -- Query-relevant flexible fields\n  tags               Array(LowCardinality(String)) DEFAULT [],\n\n  -- Information-only JSON payloads\n  metadata           Nullable(String),\n  scope              Nullable(String)\n)\nENGINE = ReplacingMergeTree\nPARTITION BY toDate(timestamp)\nORDER BY (traceId, timestamp, feedbackId)\nSETTINGS allow_nullable_key = 1\n";
@@ -51,6 +65,12 @@ export declare const DISCOVERY_MV_DDL: string[];
  * so new columns must be added explicitly via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
  */
 export declare const ALL_MIGRATIONS: string[];
+/**
+ * Names of the bloom-filter skip indexes added to `metric_events`. Exposed so
+ * tooling (e.g. a follow-up `mastra migrate` command) can detect and optionally
+ * `MATERIALIZE INDEX` them across pre-existing parts.
+ */
+export declare const METRIC_SKIP_INDEX_NAMES: readonly ["idx_traceId", "idx_threadId", "idx_resourceId", "idx_userId", "idx_organizationId", "idx_experimentId", "idx_runId", "idx_sessionId", "idx_requestId"];
 export declare const ALL_DDL: string[];
 export declare const ALL_TABLE_NAMES: string[];
 /**

package/dist/storage/domains/observability/v-next/ddl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/ddl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAC1D,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AACpD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAM9D,eAAO,MAAM,cAAc,0BAA0B,CAAC;AACtD,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAChE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAM9D,eAAO,MAAM,eAAe,ioEAiE3B,CAAC;AAMF,eAAO,MAAM,eAAe,2nEAiE3B,CAAC;AAMF,eAAO,MAAM,kBAAkB,+JAO9B,CAAC;AAMF,eAAO,MAAM,iBAAiB,8+DAyD7B,CAAC;AAMF,eAAO,MAAM,cAAc,otDAoD1B,CAAC;AAMF,eAAO,MAAM,gBAAgB,48DA4D5B,CAAC;AAMF,eAAO,MAAM,mBAAmB,qjEA+D/B,CAAC;AAMF,eAAO,MAAM,oBAAoB,2NAQhC,CAAC;AAMF,eAAO,MAAM,mBAAmB,8PAS/B,CAAC;AAyBF,eAAO,MAAM,uBAAuB,QAwBnC,CAAC;AAOF,eAAO,MAAM,sBAAsB,QAkBlC,CAAC;AAMF,eAAO,MAAM,aAAa,UASzB,CAAC;AAEF,eAAO,MAAM,UAAU,UAAuB,CAAC;AAE/C,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,UAAoD,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAyB1B,CAAC;AAEF,eAAO,MAAM,OAAO,UAAyD,CAAC;AAE9E,eAAO,MAAM,eAAe,UAS3B,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAkBtE"}
+{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/ddl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAC5D,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAC1D,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AACpD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAM9D,eAAO,MAAM,cAAc,0BAA0B,CAAC;AACtD,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAC5D,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAChE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,sHAQ1B,CAAC;AAMX,eAAO,MAAM,eAAe,ioEAiE3B,CAAC;AAMF,eAAO,MAAM,eAAe,2nEAiE3B,CAAC;AAMF,eAAO,MAAM,kBAAkB,+JAO9B,CAAC;AAcF,eAAO,MAAM,kBAAkB,woEAiE9B,CAAC;AAMF,eAAO,MAAM,qBAAqB,QAOjC,CAAC;AAMF,eAAO,MAAM,iBAAiB,i8FAwE7B,CAAC;AAMF,eAAO,MAAM,cAAc,otDAoD1B,CAAC;AAMF,eAAO,MAAM,gBAAgB,48DA4D5B,CAAC;AAMF,eAAO,MAAM,mBAAmB,qjEA+D/B,CAAC;AAMF,eAAO,MAAM,oBAAoB,2NAQhC,CAAC;AAMF,eAAO,MAAM,mBAAmB,8PAS/B,CAAC;AAyBF,eAAO,MAAM,uBAAuB,QAwBnC,CAAC;AAOF,eAAO,MAAM,sBAAsB,QAkBlC,CAAC;AAMF,eAAO,MAAM,aAAa,UAUzB,CAAC;AAEF,eAAO,MAAM,UAAU,UAA8C,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,UAAoD,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAsC1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,mKAU1B,CAAC;AAEX,eAAO,MAAM,OAAO,UAAyD,CAAC;AAE9E,eAAO,MAAM,eAAe,UAU3B,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAkBtE"}

package/dist/storage/domains/observability/v-next/index.d.ts

@@ -7,7 +7,7 @@
  * Domain layout follows DuckDB reference: thin class delegating to module functions.
  */
 import { ObservabilityStorage } from '@mastra/core/storage';
-import type { ObservabilityStorageStrategy, BatchCreateSpansArgs, BatchDeleteTracesArgs, CreateSpanArgs, GetRootSpanArgs, GetRootSpanResponse, GetSpanArgs, GetSpanResponse, GetTraceArgs, GetTraceResponse, GetTraceLightResponse, ListTracesArgs, ListTracesResponse, BatchCreateLogsArgs, ListLogsArgs, ListLogsResponse, BatchCreateMetricsArgs, ListMetricsArgs, ListMetricsResponse, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, CreateScoreArgs, BatchCreateScoresArgs, ListScoresArgs, ListScoresResponse, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse, CreateFeedbackArgs, BatchCreateFeedbackArgs, ListFeedbackArgs, ListFeedbackResponse, GetFeedbackAggregateArgs, GetFeedbackAggregateResponse, GetFeedbackBreakdownArgs, GetFeedbackBreakdownResponse, GetFeedbackTimeSeriesArgs, GetFeedbackTimeSeriesResponse, GetFeedbackPercentilesArgs, GetFeedbackPercentilesResponse, GetEntityTypesArgs, GetEntityTypesResponse, GetEntityNamesArgs, GetEntityNamesResponse, GetServiceNamesArgs, GetServiceNamesResponse, GetEnvironmentsArgs, GetEnvironmentsResponse, GetTagsArgs, GetTagsResponse } from '@mastra/core/storage';
+import type { ObservabilityStorageStrategy, BatchCreateSpansArgs, BatchDeleteTracesArgs, CreateSpanArgs, GetRootSpanArgs, GetRootSpanResponse, GetSpanArgs, GetSpanResponse, GetSpansArgs, GetSpansResponse, GetTraceArgs, GetTraceResponse, GetTraceLightResponse, ListBranchesArgs, ListBranchesResponse, ListTracesArgs, ListTracesResponse, BatchCreateLogsArgs, ListLogsArgs, ListLogsResponse, BatchCreateMetricsArgs, ListMetricsArgs, ListMetricsResponse, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, CreateScoreArgs, BatchCreateScoresArgs, ListScoresArgs, ListScoresResponse, ScoreRecord, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse, CreateFeedbackArgs, BatchCreateFeedbackArgs, ListFeedbackArgs, ListFeedbackResponse, GetFeedbackAggregateArgs, GetFeedbackAggregateResponse, GetFeedbackBreakdownArgs, GetFeedbackBreakdownResponse, GetFeedbackTimeSeriesArgs, GetFeedbackTimeSeriesResponse, GetFeedbackPercentilesArgs, GetFeedbackPercentilesResponse, GetEntityTypesArgs, GetEntityTypesResponse, GetEntityNamesArgs, GetEntityNamesResponse, GetServiceNamesArgs, GetServiceNamesResponse, GetEnvironmentsArgs, GetEnvironmentsResponse, GetTagsArgs, GetTagsResponse } from '@mastra/core/storage';
 import type { ClickhouseDomainConfig } from '../../../db/index.js';
 import type { RetentionConfig } from './ddl.js';
 export type { RetentionConfig } from './ddl.js';
@@ -37,10 +37,12 @@ export declare class ObservabilityStorageClickhouseVNext extends ObservabilitySt
     createSpan(args: CreateSpanArgs): Promise<void>;
     batchCreateSpans(args: BatchCreateSpansArgs): Promise<void>;
     getSpan(args: GetSpanArgs): Promise<GetSpanResponse | null>;
+    getSpans(args: GetSpansArgs): Promise<GetSpansResponse>;
     getRootSpan(args: GetRootSpanArgs): Promise<GetRootSpanResponse | null>;
     getTrace(args: GetTraceArgs): Promise<GetTraceResponse | null>;
     getTraceLight(args: GetTraceArgs): Promise<GetTraceLightResponse | null>;
     listTraces(args: ListTracesArgs): Promise<ListTracesResponse>;
+    listBranches(args: ListBranchesArgs): Promise<ListBranchesResponse>;
     batchCreateLogs(args: BatchCreateLogsArgs): Promise<void>;
     listLogs(args: ListLogsArgs): Promise<ListLogsResponse>;
     batchCreateMetrics(args: BatchCreateMetricsArgs): Promise<void>;
@@ -48,6 +50,7 @@ export declare class ObservabilityStorageClickhouseVNext extends ObservabilitySt
     createScore(args: CreateScoreArgs): Promise<void>;
     batchCreateScores(args: BatchCreateScoresArgs): Promise<void>;
     listScores(args: ListScoresArgs): Promise<ListScoresResponse>;
+    getScoreById(scoreId: string): Promise<ScoreRecord | null>;
     createFeedback(args: CreateFeedbackArgs): Promise<void>;
     batchCreateFeedback(args: BatchCreateFeedbackArgs): Promise<void>;
     listFeedback(args: ListFeedbackArgs): Promise<ListFeedbackResponse>;

package/dist/storage/domains/observability/v-next/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAwB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,EAC1B,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAY1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAAG;IAC9D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AA0CF,qBAAa,mCAAoC,SAAQ,oBAAoB;;gBAI/D,MAAM,EAAE,wBAAwB;IAWtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsE3B;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IA0BF,IAAoB,qBAAqB,IAAI;QAC3C,SAAS,EAAE,4BAA4B,CAAC;QACxC,SAAS,EAAE,4BAA4B,EAAE,CAAC;KAC3C,CAKA;IAMc,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3D,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAiB3D,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiBvE,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAiB9D,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAiBxE,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgB7D,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBvD,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/D,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgBhE,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7D,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgB7D,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvD,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjE,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBnE,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAgBlF,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAgBlF,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgBrF,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAoBxF,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAgB3F,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAgB3F,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAgB9F,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAoBjG,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgBrF,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgBrF,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAgBxF,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAoB3F,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAgBzE,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgBrF,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAoB3F,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAgBzE,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAgBzE,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgB5E,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgB5E,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBpD,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/index.ts"],"names":[],"mappings":"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"}

package/dist/storage/domains/observability/v-next/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAGV,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,sBAAsB,CAAC;AAyM9B,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9G;AAMD,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8B/G;AAMD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAwFrC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAyCrC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC,CAqGtC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAmCvC;AAOD,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAOrC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAsBvC"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAGV,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAE7B,MAAM,sBAAsB,CAAC;AA6N9B,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9G;AAMD,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8B/G;AAMD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAwFrC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAkDrC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC,CAqGtC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAmCvC;AAOD,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAOrC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAsBvC"}

package/dist/storage/domains/observability/v-next/scores.d.ts

@@ -1,8 +1,9 @@
 import type { ClickHouseClient } from '@clickhouse/client';
-import type { BatchCreateScoresArgs, CreateScoreArgs, ListScoresArgs, ListScoresResponse, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse } from '@mastra/core/storage';
+import type { BatchCreateScoresArgs, CreateScoreArgs, ListScoresArgs, ListScoresResponse, ScoreRecord, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse } from '@mastra/core/storage';
 export declare function createScore(client: ClickHouseClient, args: CreateScoreArgs): Promise<void>;
 export declare function batchCreateScores(client: ClickHouseClient, args: BatchCreateScoresArgs): Promise<void>;
 export declare function listScores(client: ClickHouseClient, args: ListScoresArgs): Promise<ListScoresResponse>;
+export declare function getScoreById(client: ClickHouseClient, scoreId: string): Promise<ScoreRecord | null>;
 export declare function getScoreAggregate(client: ClickHouseClient, args: GetScoreAggregateArgs): Promise<GetScoreAggregateResponse>;
 export declare function getScoreBreakdown(client: ClickHouseClient, args: GetScoreBreakdownArgs): Promise<GetScoreBreakdownResponse>;
 export declare function getScoreTimeSeries(client: ClickHouseClient, args: GetScoreTimeSeriesArgs): Promise<GetScoreTimeSeriesResponse>;

package/dist/storage/domains/observability/v-next/scores.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scores.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/scores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAGV,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC;AA6I9B,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G;AAMD,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8B5G;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CA6DpC;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CAsBpC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAwDrC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC,CAoCtC"}
+{"version":3,"file":"scores.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/scores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAGV,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC;AA6I9B,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G;AAMD,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8B5G;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAQzG;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CA6DpC;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CAsBpC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAwDrC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC,CAoCtC"}

package/dist/storage/domains/observability/v-next/tracing.d.ts

@@ -1,15 +1,30 @@
 /**
  * Tracing operations for ClickHouse v-next observability.
  *
- * Owns: batchCreateSpans, getSpan, getTrace, batchDeleteTraces, dangerouslyClearSpanEvents
- * Delegates to trace-roots.ts: listTraces, getRootSpan
+ * Owns: batchCreateSpans, getSpan, getSpans, getTrace, getTraceLight,
+ *       listBranches, batchDeleteTraces, dangerouslyClearSpanEvents.
+ * Delegates to trace-roots.ts: listTraces, getRootSpan.
+ *
+ * `listBranches` reads from the MV-fed `mastra_trace_branches` table (one row
+ * per branch anchor span). It lives here -- alongside the other read paths
+ * over the trace data -- since branches are conceptually a subset of traces.
  */
 import type { ClickHouseClient } from '@clickhouse/client';
-import type { BatchCreateSpansArgs, BatchDeleteTracesArgs, CreateSpanArgs, GetSpanArgs, GetSpanResponse, GetTraceArgs, GetTraceResponse, GetTraceLightResponse } from '@mastra/core/storage';
+import type { BatchCreateSpansArgs, BatchDeleteTracesArgs, CreateSpanArgs, GetSpanArgs, GetSpanResponse, GetSpansArgs, GetSpansResponse, GetTraceArgs, GetTraceResponse, GetTraceLightResponse, ListBranchesArgs, ListBranchesResponse } from '@mastra/core/storage';
 /** Insert a single completed span. */
 export declare function createSpan(client: ClickHouseClient, args: CreateSpanArgs): Promise<void>;
 /** Insert a batch of completed spans. */
 export declare function batchCreateSpans(client: ClickHouseClient, args: BatchCreateSpansArgs): Promise<void>;
+/**
+ * Batch-fetch spans by spanId within a trace. Single SELECT keyed by
+ * `(traceId, spanId)`; the span_events ORDER BY `(traceId, endedAt, spanId, dedupeKey)`
+ * means traceId narrowing is index-prefixed and the spanId IN(...) filter is
+ * cheap to evaluate within that range.
+ *
+ * Returns spans in arbitrary order; caller is expected to sort. Spans not
+ * found are silently omitted (callers handle the empty/partial case).
+ */
+export declare function getSpans(client: ClickHouseClient, args: GetSpansArgs): Promise<GetSpansResponse>;
 /** Get a single span by (traceId, spanId). Uses ordinary LIMIT 1. */
 export declare function getSpan(client: ClickHouseClient, args: GetSpanArgs): Promise<GetSpanResponse | null>;
 /**
@@ -36,4 +51,14 @@ export declare function getTraceLight(client: ClickHouseClient, args: GetTraceAr
 export declare function batchDeleteTraces(client: ClickHouseClient, args: BatchDeleteTracesArgs): Promise<void>;
 /** Truncate all tracing tables (span_events + trace_roots). */
 export declare function dangerouslyClearSpanEvents(client: ClickHouseClient): Promise<void>;
+/**
+ * List trace branches with optional filtering, pagination, and ordering.
+ *
+ * Reads from `mastra_trace_branches` (one row per branch anchor span). Uses
+ * the same two-stage dedupe + paginate pattern as listTraces.
+ *
+ * Filters apply to the anchor span itself (not to a containing trace root) --
+ * which is the whole point of this surface.
+ */
+export declare function listBranches(client: ClickHouseClient, args: ListBranchesArgs): Promise<ListBranchesResponse>;
 //# sourceMappingURL=tracing.d.ts.map

package/dist/storage/domains/observability/v-next/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/tracing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAS9B,sCAAsC;AACtC,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9F;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1G;AAMD,qEAAqE;AACrE,wBAAsB,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiB1G;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsB7G;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA0BvC;AAMD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5G;AAED,+DAA+D;AAC/D,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../../src/storage/domains/observability/v-next/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EAErB,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAW9B,sCAAsC;AACtC,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9F;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1G;AAMD;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBtG;AAED,qEAAqE;AACrE,wBAAsB,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiB1G;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsB7G;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA0BvC;AAMD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5G;AAED,+DAA+D;AAC/D,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2LlH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/clickhouse",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Clickhouse provider for Mastra - includes db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -30,10 +30,10 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
-    "@internal/lint": "0.0.90",
-    "@internal/storage-test-utils": "0.0.86",
-    "@internal/types-builder": "0.0.65",
-    "@mastra/core": "1.31.0"
+    "@internal/lint": "0.0.91",
+    "@internal/storage-test-utils": "0.0.87",
+    "@mastra/core": "1.32.0",
+    "@internal/types-builder": "0.0.66"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"