@mastra/libsql 1.9.0-alpha.2 → 1.9.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @mastra/libsql
 
+## 1.9.1-alpha.0
+
+### Patch Changes
+
+- Added platform channels framework with ChannelProvider interface, ChannelsStorage domain, and ChannelConnectResult discriminated union supporting OAuth, deep link, and immediate connection flows. Channels can be registered on the Mastra instance and expose connect/disconnect/list APIs for platform integrations. ([#15876](https://github.com/mastra-ai/mastra/pull/15876))
+
+- Updated dependencies [[`b2deb29`](https://github.com/mastra-ai/mastra/commit/b2deb29412b300c868655b5840463614fbb7962d), [`66644be`](https://github.com/mastra-ai/mastra/commit/66644beac1aa560f0e417956ff007c89341dc382), [`310b953`](https://github.com/mastra-ai/mastra/commit/310b95345f302dcd5ba3ed862bdc96f059d44122), [`43f0e1d`](https://github.com/mastra-ai/mastra/commit/43f0e1d5d5a74ba6fc746f2ad89ebe0c64777a7d), [`da0b9e2`](https://github.com/mastra-ai/mastra/commit/da0b9e2ba7ecc560213b426d6c097fe63946086e)]:
+  - @mastra/core@1.31.0-alpha.3
+
+## 1.9.0
+
+### Minor Changes
+
+- Use DiskANN vector_top_k() index for faster vector queries when available ([#14913](https://github.com/mastra-ai/mastra/pull/14913))
+
+  LibSQLVector.query() now automatically uses the existing DiskANN index for approximate nearest neighbor search instead of brute-force full table scans, providing 10-25x query speedups on larger datasets. Falls back to brute-force when no index exists.
+
+### Patch Changes
+
+- Add `BackgroundTasksStorage` domain implementation so `@mastra/core` background task execution works with any storage adapter. ([#15307](https://github.com/mastra-ai/mastra/pull/15307))
+
+- Added `getTraceLight` method to the observability storage, returning only lightweight span fields needed for timeline rendering. This avoids transferring heavy fields like `input`, `output`, `attributes`, and `metadata` when they are not needed. ([#15574](https://github.com/mastra-ai/mastra/pull/15574))
+
+- Updated dependencies [[`20f59b8`](https://github.com/mastra-ai/mastra/commit/20f59b876cf91199efbc49a0e36b391240708f08), [`aba393e`](https://github.com/mastra-ai/mastra/commit/aba393e2da7390c69b80e516a4f153cda6f09376), [`3d83d06`](https://github.com/mastra-ai/mastra/commit/3d83d06f776f00fb5f4163dddd32a030c5c20844), [`e2687a7`](https://github.com/mastra-ai/mastra/commit/e2687a7408790c384563816a9a28ed06735684c9), [`fdd54cf`](https://github.com/mastra-ai/mastra/commit/fdd54cf612a9af876e9fdd85e534454f6e7dd518), [`6315317`](https://github.com/mastra-ai/mastra/commit/63153175fe9a7b224e5be7c209bbebc01dd9b0d5), [`a371ac5`](https://github.com/mastra-ai/mastra/commit/a371ac534aa1bb368a1acf9d8b313378dfdc787e), [`0474c2b`](https://github.com/mastra-ai/mastra/commit/0474c2b2e7c7e1ad8691dca031284841391ff1ef), [`0a5fa1d`](https://github.com/mastra-ai/mastra/commit/0a5fa1d3cb0583889d06687155f26fd7d2edc76c), [`7e0e63e`](https://github.com/mastra-ai/mastra/commit/7e0e63e2e485e84442351f4c7a79a424c83539dc), [`ea43e64`](https://github.com/mastra-ai/mastra/commit/ea43e646dd95d507694b6112b0bf1df22ad552b2), [`f607106`](https://github.com/mastra-ai/mastra/commit/f607106854c6416c4a07d4082604b9f66d047221), [`30456b6`](https://github.com/mastra-ai/mastra/commit/30456b6b08c8fd17e109dd093b73d93b65e83bc5), [`9d11a8c`](https://github.com/mastra-ai/mastra/commit/9d11a8c1c8924eb975a245a5884d40ca1b7e0491), [`9d3b24b`](https://github.com/mastra-ai/mastra/commit/9d3b24b19407ae9c09586cf7766d38dc4dff4a69), [`00d1b16`](https://github.com/mastra-ai/mastra/commit/00d1b16b401199cb294fa23f43336547db4dca9b), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`62919a6`](https://github.com/mastra-ai/mastra/commit/62919a6ee0fbf3779ad21a97b1ec6696515d5104), [`d246696`](https://github.com/mastra-ai/mastra/commit/d246696139a3144a5b21b042d41c532688e957e1), [`354f9ce`](https://github.com/mastra-ai/mastra/commit/354f9ce1ca6af2074b6a196a23f8ec30012dccca), [`16e34ca`](https://github.com/mastra-ai/mastra/commit/16e34caa98b9a114b17a6125e4e3fd87f169d0d0), [`7020c06`](https://github.com/mastra-ai/mastra/commit/7020c0690b199d9da337f0e805f16948e557922e), [`8786a61`](https://github.com/mastra-ai/mastra/commit/8786a61fa54ba265f85eeff9985ca39863d18bb6), [`9467ea8`](https://github.com/mastra-ai/mastra/commit/9467ea87695749a53dfc041576410ebf9ee7bb67), [`7338d94`](https://github.com/mastra-ai/mastra/commit/7338d949380cf68b095342e8e42610dc51d557c1), [`c80dc16`](https://github.com/mastra-ai/mastra/commit/c80dc16e113e6cc159f510ffde501ad4711b2189), [`af8a57e`](https://github.com/mastra-ai/mastra/commit/af8a57ed9ba9685ad8601d5b71ae3706da6222f9), [`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`1bd5104`](https://github.com/mastra-ai/mastra/commit/1bd51048b6da93507276d6623e3fd96a9e1a8944), [`e9837b5`](https://github.com/mastra-ai/mastra/commit/e9837b53699e18711b09e0ca010a4106376f2653), [`8f1b280`](https://github.com/mastra-ai/mastra/commit/8f1b280b7fe6999ec654f160cb69c1a8719e7a57), [`92dcf02`](https://github.com/mastra-ai/mastra/commit/92dcf029294210ac91b090900c1a0555a425c57a), [`0fd90a2`](https://github.com/mastra-ai/mastra/commit/0fd90a215caf5fca8099c15a67ca03e4427747a3), [`8fb2405`](https://github.com/mastra-ai/mastra/commit/8fb2405138f2d208b7962ad03f121ca25bcc28c5), [`12df98c`](https://github.com/mastra-ai/mastra/commit/12df98c4904643d9481f5c78f3bed443725b4c96)]:
+  - @mastra/core@1.26.0
+
 ## 1.9.0-alpha.2
 
 ### Patch 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.9.0-alpha.2"
+  version: "1.9.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.9.0-alpha.2",
+  "version": "1.9.1-alpha.0",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-storage.md

@@ -34,6 +34,7 @@ Each provider page includes installation instructions, configuration parameters,
 - [PostgreSQL](https://mastra.ai/reference/storage/postgresql)
 - [MongoDB](https://mastra.ai/reference/storage/mongodb)
 - [Upstash](https://mastra.ai/reference/storage/upstash)
+- [Redis](https://mastra.ai/reference/storage/redis)
 - [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
 - [Cloudflare KV & Durable Objects](https://mastra.ai/reference/storage/cloudflare)
 - [Convex](https://mastra.ai/reference/storage/convex)

package/dist/docs/references/docs-memory-working-memory.md

@@ -208,7 +208,7 @@ const paragraphMemory = new Memory({
 
 ## Structured working memory
 
-Working memory can also be defined using a structured schema instead of a Markdown template. This allows you to specify the exact fields and types that should be tracked, using a [Zod](https://zod.dev/) schema. When using a schema, the agent will see and update working memory as a JSON object matching your schema.
+Working memory can also be defined using a structured schema instead of a Markdown template. This allows you to specify the exact fields and types that should be tracked, using a [Standard JSON Schema](https://standardschema.dev/json-schema) ([Zod](https://zod.dev/), [Valibot](https://valibot.dev/), [ArkType](https://arktype.io/), etc.). When using a schema, the agent will see and update working memory as a JSON object matching your schema.
 
 **Important:** You must specify either `template` or `schema`, but not both.
 

package/dist/docs/references/reference-core-mastra-class.md

@@ -49,6 +49,8 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **observability** (`ObservabilityEntrypoint`): Observability configuration for tracing and monitoring
 
+**environment** (`string`): Deployment environment name (e.g. \`production\`, \`staging\`, \`development\`). When set, automatically attached to all observability signals so they can be filtered by environment without passing \`tracingOptions.metadata.environment\` on each call. Falls back to \`process.env.NODE\_ENV\` when unset; left undefined if neither is set. Per-call \`tracingOptions.metadata.environment\` always takes precedence.
+
 **deployer** (`MastraDeployer`): An instance of a MastraDeployer for managing deployments.
 
 **server** (`ServerConfig`): Server configuration including port, host, timeout, API routes, middleware, CORS settings, and build options for Swagger UI, API request logging, and OpenAPI docs.

package/dist/docs/references/reference-storage-composite.md

@@ -218,12 +218,12 @@ const storage = new MastraCompositeStore({
 
 Observability data can quickly overwhelm general-purpose databases in production. A single agent interaction can generate hundreds of spans, and high-traffic applications can produce thousands of traces per day.
 
-**ClickHouse** is recommended for production observability because it's optimized for high-volume, write-heavy analytics workloads. Use composite storage to route observability to ClickHouse while keeping other data in your primary database:
+**[ClickHouse](https://mastra.ai/reference/storage/clickhouse)** is recommended for production observability because it's optimized for high-volume, write-heavy analytics workloads. Use composite storage to route observability to ClickHouse while keeping other data in your primary database:
 
 ```typescript
 import { MastraCompositeStore } from '@mastra/core/storage'
 import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg'
-import { ObservabilityStorageClickhouse } from '@mastra/clickhouse'
+import { ObservabilityStorageClickhouseVNext } from '@mastra/clickhouse'
 
 const storage = new MastraCompositeStore({
   id: 'composite',
@@ -231,7 +231,7 @@ const storage = new MastraCompositeStore({
     memory: new MemoryPG({ connectionString: process.env.DATABASE_URL }),
     workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
     scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
-    observability: new ObservabilityStorageClickhouse({
+    observability: new ObservabilityStorageClickhouseVNext({
       url: process.env.CLICKHOUSE_URL,
       username: process.env.CLICKHOUSE_USERNAME,
       password: process.env.CLICKHOUSE_PASSWORD,
@@ -240,4 +240,6 @@ const storage = new MastraCompositeStore({
 })
 ```
 
+> **Note:** `ObservabilityStorageClickhouseVNext` is the current observability domain implementation. The legacy `ObservabilityStorageClickhouse` class is also exported and remains supported for projects that have not migrated. See the [ClickHouse storage reference](https://mastra.ai/reference/storage/clickhouse) for details.
+
 > **Info:** This approach is also required when using storage providers that don't support observability (like Convex, DynamoDB, or Cloudflare). See the [DefaultExporter documentation](https://mastra.ai/docs/observability/tracing/exporters/default) for the full list of supported providers.

package/dist/index.cjs

@@ -3280,6 +3280,149 @@ var BlobsLibSQL = class extends storage.BlobStore {
     };
   }
 };
+var ChannelsLibSQL = class extends storage.ChannelsStorage {
+  #db;
+  #client;
+  static MANAGED_TABLES = [storage.TABLE_CHANNEL_INSTALLATIONS, storage.TABLE_CHANNEL_CONFIG];
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({
+      tableName: storage.TABLE_CHANNEL_INSTALLATIONS,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_CHANNEL_INSTALLATIONS]
+    });
+    await this.#db.createTable({
+      tableName: storage.TABLE_CHANNEL_CONFIG,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_CHANNEL_CONFIG]
+    });
+    await this.#client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_channel_installations_webhook ON "${storage.TABLE_CHANNEL_INSTALLATIONS}" ("webhookId")`
+    );
+    await this.#client.execute(
+      `CREATE INDEX IF NOT EXISTS idx_channel_installations_platform_agent ON "${storage.TABLE_CHANNEL_INSTALLATIONS}" ("platform", "agentId")`
+    );
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: storage.TABLE_CHANNEL_INSTALLATIONS });
+    await this.#db.deleteData({ tableName: storage.TABLE_CHANNEL_CONFIG });
+  }
+  async saveInstallation(installation) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    await this.#client.execute({
+      sql: `
+        INSERT INTO "${storage.TABLE_CHANNEL_INSTALLATIONS}" (id, platform, agentId, status, webhookId, data, configHash, error, createdAt, updatedAt)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(id) DO UPDATE SET
+          platform = excluded.platform,
+          agentId = excluded.agentId,
+          status = excluded.status,
+          webhookId = excluded.webhookId,
+          data = excluded.data,
+          configHash = excluded.configHash,
+          error = excluded.error,
+          updatedAt = excluded.updatedAt
+      `,
+      args: [
+        installation.id,
+        installation.platform,
+        installation.agentId,
+        installation.status,
+        installation.webhookId ?? null,
+        JSON.stringify(installation.data),
+        installation.configHash ?? null,
+        installation.error ?? null,
+        installation.createdAt?.toISOString() ?? now,
+        now
+      ]
+    });
+  }
+  async getInstallation(id) {
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${storage.TABLE_CHANNEL_INSTALLATIONS}" WHERE id = ?`,
+      args: [id]
+    });
+    const row = result.rows?.[0];
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async getInstallationByAgent(platform, agentId) {
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${storage.TABLE_CHANNEL_INSTALLATIONS}" WHERE platform = ? AND agentId = ? ORDER BY CASE status WHEN 'active' THEN 0 WHEN 'pending' THEN 1 ELSE 2 END, updatedAt DESC LIMIT 1`,
+      args: [platform, agentId]
+    });
+    const row = result.rows?.[0];
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async getInstallationByWebhookId(webhookId) {
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${storage.TABLE_CHANNEL_INSTALLATIONS}" WHERE webhookId = ?`,
+      args: [webhookId]
+    });
+    const row = result.rows?.[0];
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async listInstallations(platform) {
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${storage.TABLE_CHANNEL_INSTALLATIONS}" WHERE platform = ? ORDER BY createdAt DESC`,
+      args: [platform]
+    });
+    return result.rows.map((row) => this.#parseInstallationRow(row));
+  }
+  async deleteInstallation(id) {
+    await this.#client.execute({
+      sql: `DELETE FROM "${storage.TABLE_CHANNEL_INSTALLATIONS}" WHERE id = ?`,
+      args: [id]
+    });
+  }
+  async saveConfig(config) {
+    await this.#client.execute({
+      sql: `
+        INSERT INTO "${storage.TABLE_CHANNEL_CONFIG}" (platform, data, updatedAt)
+        VALUES (?, ?, ?)
+        ON CONFLICT(platform) DO UPDATE SET
+          data = excluded.data,
+          updatedAt = excluded.updatedAt
+      `,
+      args: [config.platform, JSON.stringify(config.data), config.updatedAt.toISOString()]
+    });
+  }
+  async getConfig(platform) {
+    const result = await this.#client.execute({
+      sql: `SELECT * FROM "${storage.TABLE_CHANNEL_CONFIG}" WHERE platform = ?`,
+      args: [platform]
+    });
+    const row = result.rows?.[0];
+    if (!row) return null;
+    return {
+      platform: row.platform,
+      data: JSON.parse(row.data || "{}"),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  async deleteConfig(platform) {
+    await this.#client.execute({
+      sql: `DELETE FROM "${storage.TABLE_CHANNEL_CONFIG}" WHERE platform = ?`,
+      args: [platform]
+    });
+  }
+  #parseInstallationRow(row) {
+    return {
+      id: row.id,
+      platform: row.platform,
+      agentId: row.agentId,
+      status: row.status,
+      webhookId: row.webhookId || void 0,
+      data: JSON.parse(row.data || "{}"),
+      configHash: row.configHash || void 0,
+      error: row.error || void 0,
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+};
 function jsonbArg(value) {
   return value === void 0 || value === null ? null : JSON.stringify(value);
 }
@@ -10973,6 +11116,7 @@ var LibSQLStore = class extends storage.MastraCompositeStore {
     const memory = new MemoryLibSQL(domainConfig);
     const observability = new ObservabilityLibSQL(domainConfig);
     const agents = new AgentsLibSQL(domainConfig);
+    const channels = new ChannelsLibSQL(domainConfig);
     const datasets = new DatasetsLibSQL(domainConfig);
     const experiments = new ExperimentsLibSQL(domainConfig);
     const promptBlocks = new PromptBlocksLibSQL(domainConfig);
@@ -10989,6 +11133,7 @@ var LibSQLStore = class extends storage.MastraCompositeStore {
       memory,
       observability,
       agents,
+      channels,
       datasets,
       experiments,
       promptBlocks,
@@ -11105,6 +11250,7 @@ Example Complex Query:
 exports.AgentsLibSQL = AgentsLibSQL;
 exports.BackgroundTasksLibSQL = BackgroundTasksLibSQL;
 exports.BlobsLibSQL = BlobsLibSQL;
+exports.ChannelsLibSQL = ChannelsLibSQL;
 exports.DatasetsLibSQL = DatasetsLibSQL;
 exports.DefaultStorage = LibSQLStore;
 exports.ExperimentsLibSQL = ExperimentsLibSQL;