@mastra/duckdb 1.3.0-alpha.0 → 1.3.0

package/dist/storage/domains/observability/tracing.d.ts

@@ -14,7 +14,21 @@ export declare function getRootSpan(db: DuckDBConnection, args: GetRootSpanArgs)
 export declare function getTrace(db: DuckDBConnection, args: GetTraceArgs): Promise<GetTraceResponse | null>;
 /** Reconstruct lightweight spans belonging to a trace (timeline fields only). */
 export declare function getTraceLight(db: DuckDBConnection, args: GetTraceArgs): Promise<GetTraceLightResponse | null>;
-/** List root spans (traces) with filtering, ordering, and pagination. */
+/**
+ * List root spans (traces) with filtering, ordering, and pagination.
+ *
+ * Instead of reconstructing every span in the table and then filtering, we:
+ *   1. Pick candidate root `(traceId, spanId)` tuples from raw `span_events`
+ *      by looking only at rows where `eventType = 'start'` and
+ *      `parentSpanId IS NULL`. All scalar filters (entity*, *Id, service,
+ *      environment, startedAt range, ...) run here, against raw columns.
+ *   2. Fully reconstruct spans only for that narrowed set, then apply
+ *      post-aggregation filters (status/tags/metadata/scope/endedAt/
+ *      hasChildError).
+ *
+ * When there are no post-aggregation filters, ordering + pagination happen
+ * inside the prefilter CTE so reconstruction runs on at most `perPage` rows.
+ */
 export declare function listTraces(db: DuckDBConnection, args: ListTracesArgs): Promise<ListTracesResponse>;
 /**
  * Reconstruct multiple spans by spanId within a single trace. Single round-trip
@@ -25,10 +39,20 @@ export declare function listTraces(db: DuckDBConnection, args: ListTracesArgs):
 export declare function getSpans(db: DuckDBConnection, args: GetSpansArgs): Promise<GetSpansResponse>;
 /**
  * List branch anchor spans (named-entity invocations) across all traces with
- * filtering, ordering, and pagination. Pre-filters raw `span_events` by
- * `spanType IN (branch types)` before the reconstruct GROUP BY, so we don't
- * pay reconstruction cost for the high-volume sub-operation events
- * (MODEL_STEP, MODEL_CHUNK, etc.) that are never anchors.
+ * filtering, ordering, and pagination.
+ *
+ * Same two-stage strategy as `listTraces`:
+ *   1. Pick candidate anchor `(traceId, spanId)` tuples from raw `span_events`
+ *      by looking only at `eventType = 'start'` rows whose `spanType` is in
+ *      {@link BRANCH_SPAN_TYPES}. Scalar filters (entity*, *Id, environment,
+ *      serviceName, startedAt range, ...) run here, against raw columns. This
+ *      avoids paying reconstruction cost for the high-volume sub-operation
+ *      events (MODEL_STEP, MODEL_CHUNK, ...) that are never anchors.
+ *   2. Reconstruct full span data only for that narrowed set, then apply
+ *      post-aggregation filters (status / metadata / tags / endedAt range).
+ *
+ * When there are no post-aggregation filters, ordering + pagination happen
+ * inside the prefilter so reconstruction runs on at most `perPage` rows.
  */
 export declare function listBranches(db: DuckDBConnection, args: ListBranchesArgs): Promise<ListBranchesResponse>;
 //# sourceMappingURL=tracing.d.ts.map

package/dist/storage/domains/observability/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EAErB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA0VvD,6CAA6C;AAC7C,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED,sEAAsE;AACtE,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtG;AAED,sDAAsD;AACtD,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG;AAMD,wDAAwD;AACxD,wBAAsB,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOtG;AAED,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOlH;AAED,kDAAkD;AAClD,wBAAsB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOzG;AAED,iFAAiF;AACjF,wBAAsB,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CASnH;AAED,yEAAyE;AACzE,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoDxG;AAQD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBlG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4E9G"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EAErB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAofvD,6CAA6C;AAC7C,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED,sEAAsE;AACtE,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtG;AAED,sDAAsD;AACtD,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG;AAMD,wDAAwD;AACxD,wBAAsB,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOtG;AAED,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOlH;AAED,kDAAkD;AAClD,wBAAsB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOzG;AAED,iFAAiF;AACjF,wBAAsB,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CASnH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2GxG;AAQD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBlG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6I9G"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/duckdb",
-  "version": "1.3.0-alpha.0",
+  "version": "1.3.0",
   "description": "DuckDB vector store provider for Mastra - embedded high-performance vector storage with HNSW indexing",
   "type": "module",
   "main": "dist/index.js",
@@ -31,10 +31,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.32.0-alpha.2"
+    "@internal/storage-test-utils": "0.0.87",
+    "@internal/lint": "0.0.91",
+    "@internal/types-builder": "0.0.66",
+    "@mastra/core": "1.32.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"