@mastra/duckdb 1.1.0-alpha.3 → 1.1.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # @mastra/duckdb
 
+## 1.1.1-alpha.0
+
+### Patch Changes
+
+- Fixed DuckDB observability migrations to support nullable score and feedback trace IDs on existing installs. ([#14942](https://github.com/mastra-ai/mastra/pull/14942))
+
+- Updated dependencies [[`ec5c319`](https://github.com/mastra-ai/mastra/commit/ec5c3197a50d034cb8e9cc494eebfddc684b5d81), [`6517789`](https://github.com/mastra-ai/mastra/commit/65177895b74b5471fe2245c7292f0176d9b3385d), [`9ad6aa6`](https://github.com/mastra-ai/mastra/commit/9ad6aa6dfe858afc6955d1df5f3f78c40bb96b9c), [`2862127`](https://github.com/mastra-ai/mastra/commit/2862127d0a7cbd28523120ad64fea067a95838e6), [`3d16814`](https://github.com/mastra-ai/mastra/commit/3d16814c395931373543728994ff45ac98093074), [`7f498d0`](https://github.com/mastra-ai/mastra/commit/7f498d099eacef64fd43ee412e3bd6f87965a8a6), [`8cf8a67`](https://github.com/mastra-ai/mastra/commit/8cf8a67b061b737cb06d501fb8c1967a98bbf3cb), [`d7827e3`](https://github.com/mastra-ai/mastra/commit/d7827e393937c6cb0c7a744dde4d31538cb542b7)]:
+  - @mastra/core@1.21.0-alpha.2
+
+## 1.1.0
+
+### Minor Changes
+
+- Added DuckDB-backed observability queries for score and feedback analytics, including aggregates like counts and averages, breakdowns by dimensions such as model or environment, time-series over fixed intervals, and percentile calculations like p50 and p95. ([#14861](https://github.com/mastra-ai/mastra/pull/14861))
+
+  ```ts
+  const result = await store.observability.getScorePercentiles({
+    scorerId: 'relevance',
+    percentiles: [0.5, 0.95],
+    interval: '1h',
+  });
+  // { series: [{ percentile: 0.5, points: [{ timestamp, value }] }, ...] }
+  ```
+
+- Adds observability storage using DuckDB for traces, metrics, logs, scores, and feedback. Exports `DuckDBStore`, `ObservabilityStorageDuckDB`, and `DuckDBConnection`. ([#14249](https://github.com/mastra-ai/mastra/pull/14249))
+
+  Older `@mastra/core` versions show an upgrade error when you use the DuckDB observability store.
+
+  ```typescript
+  import { Mastra } from '@mastra/core/mastra';
+  import { DefaultExporter, Observability } from '@mastra/observability';
+  import { MastraCompositeStore } from '@mastra/core/storage';
+  import { LibSQLStore } from '@mastra/libsql';
+  import { DuckDBStore } from '@mastra/duckdb';
+
+  const duckDBStore = new DuckDBStore();
+  const libSqlStore = new LibSQLStore();
+
+  const storage = new MastraCompositeStore({
+    id: 'composite',
+    domains: {
+      ...libSqlStore.stores,
+      observability: duckDBStore.observability,
+    },
+  });
+
+  export const mastra = new Mastra({
+    agents: {
+      /* your agents here */
+    },
+    observability: new Observability({
+      configs: {
+        default: {
+          serviceName: 'obs-test',
+          exporters: [new DefaultExporter()],
+        },
+      },
+    }),
+    storage,
+  });
+  ```
+
+- Updated DuckDB observability storage to support the current Mastra observability fields for logs, metrics, scores, and feedback. ([#14851](https://github.com/mastra-ai/mastra/pull/14851))
+
+  Scores and feedback stored in DuckDB now include the new correlation data used across Mastra observability.
+
+### Patch Changes
+
+- Fixed `'Cannot create values of type ANY'` error when querying metrics endpoints with DuckDB. Parameter binding now uses explicit typed methods instead of relying on DuckDB's type inference, which fails for certain SQL contexts like `json_extract_string`. ([#14666](https://github.com/mastra-ai/mastra/pull/14666))
+
+- Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0
+
 ## 1.1.0-alpha.3
 
 ### Minor Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.0-alpha.3",
+  "version": "1.1.1-alpha.0",
   "package": "@mastra/duckdb",
   "exports": {
     "DuckDBConnection": {

package/dist/index.cjs

@@ -583,7 +583,7 @@ var ObservabilityStorageDuckDB = class extends storage.ObservabilityStorage {
       return null;
     }
     if (!this.loadPromise) {
-      this.loadPromise = import('./observability-XVQ3ST7G.cjs').then(({ ObservabilityStorageDuckDB: ObservabilityStorageDuckDB2 }) => {
+      this.loadPromise = import('./observability-IME6BI7N.cjs').then(({ ObservabilityStorageDuckDB: ObservabilityStorageDuckDB2 }) => {
         const delegate = new ObservabilityStorageDuckDB2({ db: this.db });
         this.delegate = delegate;
         return delegate;

package/dist/index.js

@@ -582,7 +582,7 @@ var ObservabilityStorageDuckDB = class extends ObservabilityStorage {
       return null;
     }
     if (!this.loadPromise) {
-      this.loadPromise = import('./observability-VLTZBPVZ.js').then(({ ObservabilityStorageDuckDB: ObservabilityStorageDuckDB2 }) => {
+      this.loadPromise = import('./observability-J4YTASAF.js').then(({ ObservabilityStorageDuckDB: ObservabilityStorageDuckDB2 }) => {
         const delegate = new ObservabilityStorageDuckDB2({ db: this.db });
         this.delegate = delegate;
         return delegate;

package/dist/{observability-XVQ3ST7G.cjs → observability-IME6BI7N.cjs}

@@ -149,7 +149,7 @@ CREATE TABLE IF NOT EXISTS score_events (
   timestamp TIMESTAMP NOT NULL,
 
   -- IDs
-  traceId VARCHAR NOT NULL,
+  traceId VARCHAR,
   spanId VARCHAR,
   experimentId VARCHAR,
   scoreTraceId VARCHAR,
@@ -196,7 +196,7 @@ CREATE TABLE IF NOT EXISTS feedback_events (
   timestamp TIMESTAMP NOT NULL,
 
   -- IDs
-  traceId VARCHAR NOT NULL,
+  traceId VARCHAR,
   spanId VARCHAR,
   experimentId VARCHAR,
   -- Entity hierarchy
@@ -306,6 +306,7 @@ var ALL_MIGRATIONS = [
   `ALTER TABLE score_events ADD COLUMN IF NOT EXISTS scope JSON`,
   `ALTER TABLE score_events ADD COLUMN IF NOT EXISTS source VARCHAR`,
   `ALTER TABLE score_events ADD COLUMN IF NOT EXISTS scoreSource VARCHAR`,
+  `ALTER TABLE score_events ALTER COLUMN traceId DROP NOT NULL`,
   // Feedback
   `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS entityType VARCHAR`,
   `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS entityId VARCHAR`,
@@ -330,7 +331,8 @@ var ALL_MIGRATIONS = [
   `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS tags JSON`,
   `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS scope JSON`,
   `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS source VARCHAR`,
-  `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS feedbackSource VARCHAR`
+  `ALTER TABLE feedback_events ADD COLUMN IF NOT EXISTS feedbackSource VARCHAR`,
+  `ALTER TABLE feedback_events ALTER COLUMN traceId DROP NOT NULL`
 ];
 function unionDistinctQueries(selects, orderBy) {
   return `${selects.join("\nUNION\n")}
@@ -688,7 +690,7 @@ function rowToFeedbackRecord(row) {
   if (!isNaN(numValue)) value = numValue;
   return {
     timestamp: toDate(row.timestamp),
-    traceId: row.traceId,
+    traceId: row.traceId ?? null,
     spanId: row.spanId ?? null,
     experimentId: row.experimentId ?? null,
     entityType: row.entityType ?? null,
@@ -1755,7 +1757,7 @@ function toSeriesName2(values) {
 function rowToScoreRecord(row) {
   return {
     timestamp: toDate(row.timestamp),
-    traceId: row.traceId,
+    traceId: row.traceId ?? null,
     spanId: row.spanId ?? null,
     experimentId: row.experimentId ?? null,
     scoreTraceId: row.scoreTraceId ?? null,
@@ -2529,5 +2531,5 @@ var ObservabilityStorageDuckDB = class extends storage.ObservabilityStorage {
 };
 
 exports.ObservabilityStorageDuckDB = ObservabilityStorageDuckDB;
-//# sourceMappingURL=observability-XVQ3ST7G.cjs.map
-//# sourceMappingURL=observability-XVQ3ST7G.cjs.map
+//# sourceMappingURL=observability-IME6BI7N.cjs.map
+//# sourceMappingURL=observability-IME6BI7N.cjs.map