@mastra/libsql 1.17.0-alpha.1 → 1.17.0-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @mastra/libsql
 
+## 1.17.0-alpha.4
+
+### Patch Changes
+
+- Fix factory storage error classification and schema drift handling. ([#20002](https://github.com/mastra-ai/mastra/pull/20002))
+
+  - `isUniqueViolation` in the LibSQL factory storage now only matches real unique-index violations (`SQLITE_CONSTRAINT_UNIQUE` / `SQLITE_CONSTRAINT_PRIMARYKEY`). Previously any `SQLITE_CONSTRAINT` failure — including NOT NULL violations — was reported as a "Unique constraint violation", which masked the real error (seen as `Unique constraint violation on collection 'factory_rule_evaluations'` when polled ingestion inserted nullable columns into a stale table).
+  - `ensureCollections` in both the LibSQL and Postgres factory storage adapters now relaxes stale NOT NULL constraints when a column becomes nullable in the schema. Postgres uses `ALTER COLUMN ... DROP NOT NULL`; LibSQL rebuilds the table in place since SQLite cannot drop NOT NULL directly. Existing rows and unique indexes are preserved.
+
+- Updated dependencies:
+  - @mastra/core@1.52.0-alpha.13
+
+## 1.17.0-alpha.3
+
+### Minor Changes
+
+- Added configurable local journal modes while preserving WAL as the default. ([#19901](https://github.com/mastra-ai/mastra/pull/19901))
+
+  ```ts
+  const storage = new LibSQLStore({
+    id: 'local-storage',
+    url: 'file:./mastra.db',
+    journalMode: 'delete',
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`c7d30cd`](https://github.com/mastra-ai/mastra/commit/c7d30cd86009c407df91105591f03cd6e3d2854d), [`ef03fbc`](https://github.com/mastra-ai/mastra/commit/ef03fbcc556bcbc04c9b3d06fab88771ecaa043c), [`a7bbe77`](https://github.com/mastra-ai/mastra/commit/a7bbe773577f60bc4761b534ef7ec6b476332dad), [`a7bbe77`](https://github.com/mastra-ai/mastra/commit/a7bbe773577f60bc4761b534ef7ec6b476332dad), [`4e68363`](https://github.com/mastra-ai/mastra/commit/4e683634f94ebd062d26a3bb6093a8dfc7263d37), [`9251370`](https://github.com/mastra-ai/mastra/commit/9251370ad413af464aa22d7566338bec5613e8de)]:
+  - @mastra/core@1.52.0-alpha.11
+
+## 1.17.0-alpha.2
+
+### Patch Changes
+
+- Replaced GitHub-specific Mastra Code session state with Factory project and linked-repository identities. This lets SDK consumers represent sessions independently of a source-control provider and select a repository explicitly when sandbox execution is required. ([#19849](https://github.com/mastra-ai/mastra/pull/19849))
+
+  Updated Mastra Code onboarding to be Factory-first: create a Factory by name, then link repositories from your connected source-control installations in a separate step. A Factory is valid with zero linked repositories, and the Board, Metrics, and Audit pages stay available for any server-backed Factory. Factory pages keep project-scoped data separate from repository-scoped intake and provide a repository selector when a Factory has multiple linked repositories. Creating a Factory from a local folder remains available as a secondary option.
+
+  **Before**
+
+  ```ts
+  const state = { githubProjectId: 'project-1', sandboxId, sandboxWorkdir };
+  ```
+
+  **After**
+
+  ```ts
+  const state = {
+    factoryProjectId: 'factory-project-1',
+    projectRepositoryId: 'project-repository-1',
+    sandboxId,
+    sandboxWorkdir,
+  };
+  ```
+
+- Updated dependencies [[`41a5392`](https://github.com/mastra-ai/mastra/commit/41a5392d9f6c5e18d6b227f0fc0ddf49c50774e9), [`675fbff`](https://github.com/mastra-ai/mastra/commit/675fbff84d3274391b33e852f76083c38a5514e5), [`da009e1`](https://github.com/mastra-ai/mastra/commit/da009e1aacd89ed94b8d1b2af09c9d4fe7c4db49), [`35c2181`](https://github.com/mastra-ai/mastra/commit/35c2181e6a50e47c90ba36260db7c9723d54696f), [`b4b7ea8`](https://github.com/mastra-ai/mastra/commit/b4b7ea8733f033fc441ea47ed03f6afb17ec2248), [`675fbff`](https://github.com/mastra-ai/mastra/commit/675fbff84d3274391b33e852f76083c38a5514e5), [`c328769`](https://github.com/mastra-ai/mastra/commit/c3287698ff8ef98dba86d415faa566fa3e5f4d56), [`232fcbc`](https://github.com/mastra-ai/mastra/commit/232fcbc14fce625dd672ba043329c0b732c62be2), [`3491666`](https://github.com/mastra-ai/mastra/commit/34916663c4fdd43b48c21f4ab2d5fb6dcccc94f9)]:
+  - @mastra/core@1.52.0-alpha.10
+
 ## 1.17.0-alpha.1
 
 ### Minor Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.17.0-alpha.1",
+  "version": "1.17.0-alpha.4",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-agent-builder-overview.md

@@ -88,6 +88,8 @@ Start Mastra's development server:
 npx mastra dev
 ```
 
+For Agent Builder development, you can also use `mastra factory dev`, which uses the same dev runtime and flags as `mastra dev` and writes to the same `.mastra/output` directory. Both commands share a dev lock and can't run simultaneously in the same project. See the [CLI reference](https://mastra.ai/reference/cli/mastra) for details.
+
 The Agent Builder is mounted at `http://localhost:4111/agent-builder`.
 
 ## Disabling the Builder

package/dist/index.cjs

@@ -13365,8 +13365,10 @@ function assertIdentifier(kind, name) {
   }
 }
 function isUniqueViolation(error) {
+  const code = typeof error === "object" && error !== null ? error.code : void 0;
+  if (code === "SQLITE_CONSTRAINT_UNIQUE" || code === "SQLITE_CONSTRAINT_PRIMARYKEY") return true;
   const message = error instanceof Error ? error.message : String(error);
-  return message.includes("UNIQUE constraint failed") || message.includes("SQLITE_CONSTRAINT");
+  return message.includes("UNIQUE constraint failed") || message.includes("SQLITE_CONSTRAINT_UNIQUE") || message.includes("SQLITE_CONSTRAINT_PRIMARYKEY");
 }
 function primaryKeyOf(schema) {
   const pks = Object.entries(schema.columns).filter(([, spec]) => spec.type === "uuid-pk" || spec.primaryKey);
@@ -13676,6 +13678,20 @@ var LibSQLFactoryStorage = class extends storage.FactoryStorage {
   async initStorage() {
     await this.#client.execute("SELECT 1");
   }
+  async withTransaction(fn) {
+    if (this.#config.url.includes(":memory:")) return fn(this.ops);
+    const transaction = await this.#client.transaction("write");
+    try {
+      const result = await fn(new LibSQLFactoryStorageOps(transaction, this.#schemas));
+      await transaction.commit();
+      return result;
+    } catch (error) {
+      await transaction.rollback();
+      throw error;
+    } finally {
+      transaction.close();
+    }
+  }
   async ensureCollections(schemas) {
     for (const schema of schemas) {
       await this.#ensureCollection(schema);
@@ -13696,6 +13712,35 @@ var LibSQLFactoryStorage = class extends storage.FactoryStorage {
     if (spec.default !== void 0) ddl += ` DEFAULT ${serializeDefault(spec.default)}`;
     return ddl;
   }
+  /**
+   * A table created by an older schema may still say NOT NULL on a column the
+   * current schema declares nullable — inserts of null then fail on databases
+   * that predate the change. SQLite has no `ALTER COLUMN DROP NOT NULL`, so
+   * relaxation swaps in a table rebuilt from the current schema (create shadow
+   * → copy → drop → rename) atomically.
+   */
+  async #relaxDriftedNotNulls(schema) {
+    const info = await this.#client.execute(`PRAGMA table_info("${schema.name}")`);
+    const hasDrift = info.rows.some((row) => {
+      const spec = schema.columns[String(row.name)];
+      if (!spec || spec.type === "uuid-pk" || spec.primaryKey) return false;
+      return spec.nullable === true && Number(row.notnull) === 1;
+    });
+    if (!hasDrift) return;
+    const ddl = Object.entries(schema.columns).map(([name, spec]) => this.#columnDdl(name, spec));
+    const shadow = `${schema.name}__nullable_rebuild`;
+    const cols = Object.keys(schema.columns).map((name) => `"${name}"`).join(", ");
+    await this.#client.batch(
+      [
+        `DROP TABLE IF EXISTS "${shadow}"`,
+        `CREATE TABLE "${shadow}" (${ddl.join(", ")})`,
+        `INSERT INTO "${shadow}" (${cols}) SELECT ${cols} FROM "${schema.name}"`,
+        `DROP TABLE "${schema.name}"`,
+        `ALTER TABLE "${shadow}" RENAME TO "${schema.name}"`
+      ],
+      "write"
+    );
+  }
   async #ensureCollection(schema) {
     assertIdentifier("collection", schema.name);
     primaryKeyOf(schema);
@@ -13707,6 +13752,7 @@ var LibSQLFactoryStorage = class extends storage.FactoryStorage {
       if (existing.has(name)) continue;
       await this.#client.execute(`ALTER TABLE "${schema.name}" ADD COLUMN ${this.#columnDdl(name, spec)}`);
     }
+    await this.#relaxDriftedNotNulls(schema);
     for (const index of schema.uniqueIndexes ?? []) {
       assertIdentifier("index", index.name);
       index.columns.forEach((column) => assertIdentifier("column", column));