@mastra/pg 1.13.0-alpha.1 → 1.13.2

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # @mastra/pg
 
+## 1.13.1
+
+### Patch Changes
+
+- Fix `PostgresStore` startup failing with `canceling statement due to statement timeout` when running behind a transaction pooler such as Supabase or PgBouncer. Initialization now reuses a single pooled connection for the duration of startup, so storage initializes reliably with observability enabled. Runtime queries are unaffected. Fixes #17679. ([#17833](https://github.com/mastra-ai/mastra/pull/17833))
+
+- Fixed skill updates creating duplicate versions when a snapshot had not meaningfully changed. Comparison previously relied on `JSON.stringify`, so reordered object keys (common with PostgreSQL JSONB) or optional fields round-tripping between `undefined` and `null` looked like changes. Skill snapshots are now compared by value, so repeated no-op publish/update cycles no longer increment the version number. ([#16811](https://github.com/mastra-ai/mastra/pull/16811))
+
+- Updated dependencies [[`de66bb0`](https://github.com/mastra-ai/mastra/commit/de66bb040570444c702ce4d8e1e228a5de2949cb), [`67bf8e2`](https://github.com/mastra-ai/mastra/commit/67bf8e206dfe583954d96015cf0d09f7ac50e45f), [`8216d05`](https://github.com/mastra-ai/mastra/commit/8216d0528d866eb9a07f5d4c87ea3bb1e1139b45), [`d18b23c`](https://github.com/mastra-ai/mastra/commit/d18b23c5e29dfc381e73e3c51fcf6c779afd1823), [`5eb94eb`](https://github.com/mastra-ai/mastra/commit/5eb94ebcf66d4e28c9e26d5821ac93379bab20a0), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`f9ee2ac`](https://github.com/mastra-ai/mastra/commit/f9ee2ac661af584e61bc063ac208c9035cd752ef), [`c853d53`](https://github.com/mastra-ai/mastra/commit/c853d535d2df84ab89db1adb4c28900c54c9a2d2), [`d8df1f8`](https://github.com/mastra-ai/mastra/commit/d8df1f8e947e1966c9d4e54713df56d0d0d65226), [`9192ddb`](https://github.com/mastra-ai/mastra/commit/9192ddbced8949113b30de444cbe763f075b59f5), [`ae96523`](https://github.com/mastra-ai/mastra/commit/ae965231f562d9766b0c90c49a69fc68acaa031c), [`17d5a92`](https://github.com/mastra-ai/mastra/commit/17d5a9211aa293b4d4418de3de70dc0394d58101), [`5573693`](https://github.com/mastra-ai/mastra/commit/5573693b589822250e20dfe6cf66e9ff3bc96da8), [`ec4da8a`](https://github.com/mastra-ai/mastra/commit/ec4da8a09e0d2ab452c6ee2c786042ea826b77e5), [`adc44e1`](https://github.com/mastra-ai/mastra/commit/adc44e13c7e570b91e86b20ea7556e61d819db31), [`ed346c0`](https://github.com/mastra-ai/mastra/commit/ed346c0bee2d8496690a4e538bfba1e46894660f), [`c9ce1b2`](https://github.com/mastra-ai/mastra/commit/c9ce1b28d10871110648f9d7b6d76e880b9fa999), [`3ef01fd`](https://github.com/mastra-ai/mastra/commit/3ef01fd130b53d5bd4f828beb174e516a2eb1158), [`245a9a3`](https://github.com/mastra-ai/mastra/commit/245a9a315705fce17ddd980f78a92504b6615c4a), [`dc0b611`](https://github.com/mastra-ai/mastra/commit/dc0b6119b769bd00ee2c5df9259fb376fe63077a), [`38b5de8`](https://github.com/mastra-ai/mastra/commit/38b5de8e5d1d41a69522addf53d96f4b3a1d5bf0), [`dc0b611`](https://github.com/mastra-ai/mastra/commit/dc0b6119b769bd00ee2c5df9259fb376fe63077a), [`dd6a66e`](https://github.com/mastra-ai/mastra/commit/dd6a66ea0b32e0dea8059aec6b35d151e2c87dc4), [`d785c59`](https://github.com/mastra-ai/mastra/commit/d785c593b67fcb4cdc4fab9fdbde5f3b7665efc0), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`8b984f4`](https://github.com/mastra-ai/mastra/commit/8b984f4361c202270ceb69257185c4756c9a7c56), [`bf08402`](https://github.com/mastra-ai/mastra/commit/bf084022374fa5d06ca70ed67a86dd64e379071b), [`81fe587`](https://github.com/mastra-ai/mastra/commit/81fe587275035715c1720ddf3fee0505cf053036), [`1fa3e12`](https://github.com/mastra-ai/mastra/commit/1fa3e123582b63cfe49de4ee52dc6a065e8d956a), [`403c438`](https://github.com/mastra-ai/mastra/commit/403c438e417278989ce247233d2c465b8d902cdd), [`f8ba195`](https://github.com/mastra-ai/mastra/commit/f8ba1954e27ee2b20586cc6cd9cf13c002c232f2)]:
+  - @mastra/core@1.43.0
+
+## 1.13.0
+
+### Minor Changes
+
+- Add the v-next observability storage domain for `@mastra/pg`, an insert-only, ([#16760](https://github.com/mastra-ai/mastra/pull/16760))
+  partitioned Postgres adapter for low-volume observability (~100 calls/sec,
+  up to roughly 1,500 calls/sec sustained on a single primary).
+
+  The new `PostgresStoreVNext` composes a primary `PostgresStore` (memory,
+  workflows, scores, agents, etc.) with an `ObservabilityStoragePostgresVNext`
+  for spans, logs, metrics, scores, and feedback. All observability writes go
+  through a single multi-row `INSERT ... ON CONFLICT DO NOTHING` path. Storage
+  is partitioned per day with three modes auto-detected at `init()` time:
+  TimescaleDB hypertables, pg_partman (4.x or 5.x), or native Postgres range
+  partitions. Root-span lookups are served by partial indexes, and OLAP queries
+  (aggregates, breakdowns, time-series, percentiles) prune partitions by
+  `timestamp`. A small discovery cache table powers stale-while-revalidate
+  lookups for entity names/types/labels.
+
+  The `observability` connection is **required** — callers always make an
+  explicit decision about where observability data lives. For production,
+  point it at a dedicated Postgres instance to keep OLAP scans from
+  contending with your primary OLTP workload. Reusing the primary
+  connection works for local development and logs a runtime warning on every
+  construction.
+
+  ```typescript
+  import { Mastra } from '@mastra/core';
+  import { PostgresStoreVNext } from '@mastra/pg';
+
+  export const mastra = new Mastra({
+    storage: new PostgresStoreVNext({
+      id: 'app',
+      connectionString: process.env.DATABASE_URL!,
+      observability: {
+        connectionString: process.env.OBSERVABILITY_DATABASE_URL!,
+      },
+    }),
+  });
+  ```
+
+  Delta polling uses Postgres transaction IDs and a safe transaction horizon so
+  concurrent writers cannot cause late-committing rows to be skipped. The
+  `observability-delta-polling` feature flag is opt-in.
+
+  `ensureNativePartitions()` swallows the `42P07 relation already exists`
+  error around `CREATE TABLE IF NOT EXISTS … PARTITION OF`, matching the
+  existing guard used for base-table and index DDL. This makes concurrent
+  `init()` from two processes (serverless cold-start, blue/green overlap, two
+  stores sharing a schema) idempotent instead of letting the loser surface an
+  unhandled duplicate-relation error.
+
+### Patch Changes
+
+- dependencies updates: ([#17148](https://github.com/mastra-ai/mastra/pull/17148))
+  - Updated dependency [`pg@^8.21.0` ↗︎](https://www.npmjs.com/package/pg/v/8.21.0) (from `^8.20.0`, in `dependencies`)
+
+- Added full Agent Builder storage support to the PostgreSQL adapter, bringing it to parity with libSQL. ([#17596](https://github.com/mastra-ai/mastra/pull/17596))
+
+  Previously, projects using PostgreSQL could not store tool provider connections or agent tool providers, and several Agent Builder tables were missing from the exported schema.
+  - Added storage for tool provider connections, so connections can be created, read, listed by author, and deleted on PostgreSQL.
+  - Agent versions now persist their tool providers on PostgreSQL across save and load.
+  - Fixed schema export so all Agent Builder tables are included.
+
+- Fixed `PgVector` ignoring an explicit `ssl` option when the connection string also contained an `sslmode=` (or `ssl=`) query parameter. `node-postgres` re-parses the connection string and overwrote the explicit `ssl` object, causing `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` / "self-signed certificate" errors against self-signed or internal CAs even when verification was meant to be skipped. ([#17650](https://github.com/mastra-ai/mastra/pull/17650))
+
+  `PgVector` now honors an explicit `ssl` option over the connection string, matching the existing `PostgresStore` behavior. Connection-string-only SSL (`?sslmode=require` with no explicit `ssl`) keeps working as before.
+
+  ```ts
+  import { PgVector } from '@mastra/pg';
+
+  // This now connects instead of throwing UNABLE_TO_GET_ISSUER_CERT_LOCALLY
+  const vector = new PgVector({
+    id: 'my-vector',
+    connectionString: 'postgresql://user:pass@host:5432/db?sslmode=require',
+    ssl: { rejectUnauthorized: false },
+  });
+  ```
+
+- Make atomic db updates better ([#16796](https://github.com/mastra-ai/mastra/pull/16796))
+
+- Updated dependencies [[`d468acb`](https://github.com/mastra-ai/mastra/commit/d468acb07aec1bb19a2cb0ada8042b05b46746b2), [`575f815`](https://github.com/mastra-ai/mastra/commit/575f815c5c3567b71c0b83cbb7fa98c8253a9d9c), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`053735a`](https://github.com/mastra-ai/mastra/commit/053735a75c2c18e23ce34d9468007efa4a45f4c4), [`306909a`](https://github.com/mastra-ai/mastra/commit/306909a693de77d709b38706e2673c9547d24a28), [`5191af8`](https://github.com/mastra-ai/mastra/commit/5191af80c799eea25357c545fc05d91b3883531d), [`43bd3d4`](https://github.com/mastra-ai/mastra/commit/43bd3d421987463fdf35386a45199c49499ed069), [`e6fa79e`](https://github.com/mastra-ai/mastra/commit/e6fa79ec72a2ddffdd25e85270398951e9d552a4), [`904bcdf`](https://github.com/mastra-ai/mastra/commit/904bcdf7b8004aa7be823f9f70ca63580e47e470), [`7f5ee1d`](https://github.com/mastra-ai/mastra/commit/7f5ee1dca46daee8d2817f2ebe49e6335da81956), [`1e9aab5`](https://github.com/mastra-ai/mastra/commit/1e9aab50ff11e6e88fde4d7cbf512c44a9fe8d61), [`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`bf8eb6d`](https://github.com/mastra-ai/mastra/commit/bf8eb6d0ec213a403eb9265a594ad283c44ab3dc), [`e9be4e7`](https://github.com/mastra-ai/mastra/commit/e9be4e747ec3d8b65548bff92f9377db06105376), [`493a328`](https://github.com/mastra-ai/mastra/commit/493a328f4346a1deeb9f1e2e44c8f2a3a4d7591b), [`d53cfc2`](https://github.com/mastra-ai/mastra/commit/d53cfc2c7f8d78343a4aa84ec4e129ba25f3325e), [`65799d4`](https://github.com/mastra-ai/mastra/commit/65799d4d549e5ebb9c848fbe3f51ac090f64becf), [`c268c89`](https://github.com/mastra-ai/mastra/commit/c268c89f4c63a93ee474d3cffdf3ea60bf00d4f2), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`014e00f`](https://github.com/mastra-ai/mastra/commit/014e00f2b3a597a016b72f9901c6ab27d491f822), [`029a414`](https://github.com/mastra-ai/mastra/commit/029a4141719793bd3e898a39eb5a0466a55f5f3a), [`d468acb`](https://github.com/mastra-ai/mastra/commit/d468acb07aec1bb19a2cb0ada8042b05b46746b2), [`b147b29`](https://github.com/mastra-ai/mastra/commit/b147b2907f0cd1aa812efe6d6e3f58d22e66fc88), [`d371ac1`](https://github.com/mastra-ai/mastra/commit/d371ac1d9820afaaf7cfdbc380a475946a994d8f), [`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`0c72f03`](https://github.com/mastra-ai/mastra/commit/0c72f032abb13254df5a7856d64be2f207b8006d), [`cf182b7`](https://github.com/mastra-ai/mastra/commit/cf182b7fb495767946d9840ef29f19cfa906f31f), [`3b45ea9`](https://github.com/mastra-ai/mastra/commit/3b45ea95015557a6cb9d70dc5252af54ab1b78ac), [`a049c2a`](https://github.com/mastra-ai/mastra/commit/a049c2a9dfb41d0ee2e7a28874a88cd64fd5669f), [`f084be1`](https://github.com/mastra-ai/mastra/commit/f084be1fcbe33ad7480913e44d6130c421c0976f), [`b147b29`](https://github.com/mastra-ai/mastra/commit/b147b2907f0cd1aa812efe6d6e3f58d22e66fc88), [`2a96528`](https://github.com/mastra-ai/mastra/commit/2a9652848dfa3c5a2426f952e9d93554c26fd90f), [`f2ab060`](https://github.com/mastra-ai/mastra/commit/f2ab060162bea81505fda553e2cee29c1979fd04), [`5d302c8`](https://github.com/mastra-ai/mastra/commit/5d302c8eda1a6ac74eab5e442c4f64db6cc97a06), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`a952852`](https://github.com/mastra-ai/mastra/commit/a952852c971a21fb646cd907c75fcf4443cdc963), [`2656d9c`](https://github.com/mastra-ai/mastra/commit/2656d9c2976d4f3354253bfbbbf9b88a1b2bbf34), [`63e3fe1`](https://github.com/mastra-ai/mastra/commit/63e3fe13cc1ea96f91d7c68aea92f400faf9e4da), [`1d4ce8d`](https://github.com/mastra-ai/mastra/commit/1d4ce8daaa54511f325c1b609d31b8e54009d677), [`8c68372`](https://github.com/mastra-ai/mastra/commit/8c68372e85fe0b066ec12c58bd29ffb93e54c552)]:
+  - @mastra/core@1.42.0
+
 ## 1.13.0-alpha.1
 
 ### Patch Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.13.0-alpha.1",
+  "version": "1.13.2",
   "package": "@mastra/pg",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -15,6 +15,7 @@ var module$1 = require('module');
 var agent = require('@mastra/core/agent');
 var features = require('@mastra/core/features');
 var evals = require('@mastra/core/evals');
+var skills = require('@mastra/core/storage/domains/skills');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -2164,6 +2165,161 @@ var TransactionClient = class {
     return Promise.all(promises);
   }
 };
+var PinnedClientAdapter = class {
+  constructor($pool, pinnedClient) {
+    this.$pool = $pool;
+    this.pinnedClient = pinnedClient;
+  }
+  $pool;
+  pinnedClient;
+  /**
+   * Serialization tail. Domain init() methods fire via Promise.all in
+   * MastraCompositeStore.#runInit(), so without our own gate every domain's
+   * query() lands on the same PoolClient concurrently. pg@8 queues those
+   * internally and emits a deprecation warning; pg@9 will throw. Chaining
+   * each new query off the previous one's settlement (success or failure)
+   * gives us deterministic FIFO ordering at the adapter layer and removes
+   * the reliance on pg's internal queue.
+   */
+  #tail = Promise.resolve();
+  /**
+   * Run `fn` after any previously enqueued work on this pinned client has
+   * settled. Failures in earlier calls don't poison the queue — we always
+   * resume on the next caller's turn.
+   */
+  #enqueue(fn) {
+    const next = this.#tail.then(fn, fn);
+    this.#tail = next.catch(() => void 0);
+    return next;
+  }
+  connect() {
+    throw new Error(
+      "PinnedClientAdapter.connect() is not supported during PostgresStore.init(). All DDL must flow through the pinned client."
+    );
+  }
+  none(query, values) {
+    return this.#enqueue(async () => {
+      await this.pinnedClient.query(query, values);
+      return null;
+    });
+  }
+  one(query, values) {
+    return this.#enqueue(async () => {
+      const result = await this.pinnedClient.query(query, values);
+      if (result.rows.length === 0) {
+        throw new Error(`No data returned from query: ${truncateQuery(query)}`);
+      }
+      if (result.rows.length > 1) {
+        throw new Error(`Multiple rows returned when one was expected: ${truncateQuery(query)}`);
+      }
+      return result.rows[0];
+    });
+  }
+  oneOrNone(query, values) {
+    return this.#enqueue(async () => {
+      const result = await this.pinnedClient.query(query, values);
+      if (result.rows.length === 0) {
+        return null;
+      }
+      if (result.rows.length > 1) {
+        throw new Error(`Multiple rows returned when one or none was expected: ${truncateQuery(query)}`);
+      }
+      return result.rows[0];
+    });
+  }
+  any(query, values) {
+    return this.#enqueue(async () => {
+      const result = await this.pinnedClient.query(query, values);
+      return result.rows;
+    });
+  }
+  manyOrNone(query, values) {
+    return this.any(query, values);
+  }
+  many(query, values) {
+    return this.#enqueue(async () => {
+      const result = await this.pinnedClient.query(query, values);
+      if (result.rows.length === 0) {
+        throw new Error(`No data returned from query: ${truncateQuery(query)}`);
+      }
+      return result.rows;
+    });
+  }
+  query(query, values) {
+    return this.#enqueue(() => this.pinnedClient.query(query, values));
+  }
+  tx(callback) {
+    return this.#enqueue(async () => {
+      await this.pinnedClient.query("BEGIN");
+      try {
+        const result = await callback(new TransactionClient(this.pinnedClient));
+        await this.pinnedClient.query("COMMIT");
+        return result;
+      } catch (error) {
+        try {
+          await this.pinnedClient.query("ROLLBACK");
+        } catch (rollbackError) {
+          console.error("Transaction rollback failed:", rollbackError);
+        }
+        throw error;
+      }
+    });
+  }
+};
+var RoutingDbClient = class {
+  #base;
+  #pinned = null;
+  constructor(base) {
+    this.#base = base;
+  }
+  /** Returns the currently active client (pinned if set, otherwise base). */
+  get active() {
+    return this.#pinned ?? this.#base;
+  }
+  /**
+   * Pin a DbClient so all subsequent calls route through it until unpinned.
+   * Throws if a client is already pinned to avoid silent overrides.
+   */
+  pin(client) {
+    if (this.#pinned) {
+      throw new Error("RoutingDbClient already has a pinned client");
+    }
+    this.#pinned = client;
+  }
+  unpin() {
+    this.#pinned = null;
+  }
+  get $pool() {
+    return this.#base.$pool;
+  }
+  connect() {
+    return this.active.connect();
+  }
+  none(query, values) {
+    return this.active.none(query, values);
+  }
+  one(query, values) {
+    return this.active.one(query, values);
+  }
+  oneOrNone(query, values) {
+    return this.active.oneOrNone(query, values);
+  }
+  any(query, values) {
+    return this.active.any(query, values);
+  }
+  manyOrNone(query, values) {
+    return this.active.manyOrNone(query, values);
+  }
+  many(query, values) {
+    return this.active.many(query, values);
+  }
+  query(query, values) {
+    return this.active.query(query, values);
+  }
+  tx(callback) {
+    return this.active.tx(callback);
+  }
+};
 
 // src/storage/db/constraint-utils.ts
 var POSTGRES_IDENTIFIER_MAX_LENGTH = 63;
@@ -17062,7 +17218,10 @@ var SkillsPG = class _SkillsPG extends storage.SkillsStorage {
         } = latestVersion;
         const newConfig = { ...latestConfig, ...configFields };
         const changedFields = SNAPSHOT_FIELDS5.filter(
-          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
+          (field) => field in configFields && !skills.skillSnapshotFieldValuesEqual(
+            configFields[field],
+            latestConfig[field]
+          )
         );
         if (changedFields.length > 0) {
           versionCreated = true;
@@ -19006,6 +19165,8 @@ function exportSchemas(schemaName) {
 }
 var PostgresStore = class extends storage.MastraCompositeStore {
   #pool;
+  // Narrowed to RoutingDbClient so init()'s pin/unpin path is type-checked.
+  // The public `db` getter still exposes it as DbClient.
   #db;
   #ownsPool;
   #poolClosed = false;
@@ -19024,7 +19185,7 @@ var PostgresStore = class extends storage.MastraCompositeStore {
         this.#pool = this.createPool(config);
         this.#ownsPool = true;
       }
-      this.#db = new PoolAdapter(this.#pool);
+      this.#db = new RoutingDbClient(new PoolAdapter(this.#pool));
       const domainConfig = {
         client: this.#db,
         schemaName: this.schema,
@@ -19080,11 +19241,13 @@ var PostgresStore = class extends storage.MastraCompositeStore {
     if (this.isInitialized) {
       return;
     }
+    const pinnedClient = await this.#pool.connect();
+    const pinned = new PinnedClientAdapter(this.#pool, pinnedClient);
     try {
-      this.isInitialized = true;
+      this.#db.pin(pinned);
       await super.init();
+      this.isInitialized = true;
     } catch (error$1) {
-      this.isInitialized = false;
       if (error$1 instanceof error.MastraError) {
         throw error$1;
       }
@@ -19096,6 +19259,9 @@ var PostgresStore = class extends storage.MastraCompositeStore {
         },
         error$1
       );
+    } finally {
+      this.#db.unpin();
+      pinnedClient.release();
     }
   }
   /**