@mastra/convex 1.1.0-alpha.0 → 1.2.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,134 @@
 # @mastra/convex
 
+## 1.2.0-alpha.0
+
+### Minor Changes
+
+- Convex can now persist channel installations and provider configuration. ([#16718](https://github.com/mastra-ai/mastra/pull/16718))
+
+  ```ts
+  import { ConvexStore } from '@mastra/convex';
+
+  const storage = new ConvexStore({
+    id: 'app-storage',
+    deploymentUrl: process.env.CONVEX_URL!,
+    adminAuthToken: process.env.CONVEX_ADMIN_KEY!,
+  });
+
+  const channels = await storage.getStore('channels');
+
+  await channels?.saveInstallation({
+    id: 'slack-agent-1',
+    platform: 'slack',
+    agentId: 'agent-1',
+    status: 'active',
+    webhookId: 'webhook-1',
+    data: { teamId: 'T123', botUserId: 'U123' },
+    createdAt: new Date(),
+    updatedAt: new Date(),
+  });
+  ```
+
+- Workflow schedules can now be stored in Convex. ([#16710](https://github.com/mastra-ai/mastra/pull/16710))
+
+  ```ts
+  import { ConvexStore } from '@mastra/convex';
+
+  const storage = new ConvexStore({
+    id: 'app-storage',
+    deploymentUrl: process.env.CONVEX_URL!,
+    adminAuthToken: process.env.CONVEX_ADMIN_KEY!,
+  });
+
+  const schedules = await storage.getStore('schedules');
+
+  await schedules?.createSchedule({
+    id: 'daily-summary',
+    target: { type: 'workflow', workflowId: 'summary-workflow' },
+    cron: '0 9 * * *',
+    status: 'active',
+    nextFireAt: Date.now(),
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+  });
+  ```
+
+### Patch Changes
+
+- Improved Convex background task reliability with safer lifecycle updates, faster filtering, and smoother upgrades from older storage rows. ([#16724](https://github.com/mastra-ai/mastra/pull/16724))
+
+- Updated dependencies [[`0cbece9`](https://github.com/mastra-ai/mastra/commit/0cbece9d832cb134a74cdbf3682d390a058215a4), [`7dfe1bc`](https://github.com/mastra-ai/mastra/commit/7dfe1bcfe71d261a6fd6bbf29b1dec49d78fb98f), [`70cb714`](https://github.com/mastra-ai/mastra/commit/70cb7149c8f16f478e15b58498254a53181750a4), [`7f9da22`](https://github.com/mastra-ai/mastra/commit/7f9da22efd5aa595e138a31de55a5f0f2f28b33d)]:
+  - @mastra/core@1.37.0-alpha.6
+
+## 1.1.0
+
+### Minor Changes
+
+- Added native Convex vector search support for production workloads. The new `ConvexNativeVector` adapter uses ([#16729](https://github.com/mastra-ai/mastra/pull/16729))
+  Convex schema-defined vector indexes and `ctx.vectorSearch` instead of loading vectors through `ConvexVector` and
+  scoring them in JavaScript.
+
+  Define a native vector table in `convex/schema.ts`:
+
+  ```ts
+  import { defineSchema } from 'convex/server';
+  import { defineMastraNativeVectorTable } from '@mastra/convex/schema';
+
+  export default defineSchema({
+    docs_vectors: defineMastraNativeVectorTable({
+      dimensions: 1536,
+    }),
+  });
+  ```
+
+  Export the native vector handlers:
+
+  ```ts
+  import { mastraNativeVectorAction, mastraNativeVectorMutation, mastraNativeVectorQuery } from '@mastra/convex/server';
+
+  export const query = mastraNativeVectorAction;
+  export const read = mastraNativeVectorQuery;
+  export const write = mastraNativeVectorMutation;
+  ```
+
+  Then configure `ConvexNativeVector` in your Mastra app:
+
+  ```ts
+  import { ConvexNativeVector } from '@mastra/convex';
+
+  const vectorStore = new ConvexNativeVector({
+    id: 'convex-native-vectors',
+    deploymentUrl: process.env.CONVEX_URL!,
+    adminAuthToken: process.env.CONVEX_ADMIN_KEY!,
+    indexes: {
+      docs: {
+        tableName: 'docs_vectors',
+        vectorIndexName: 'by_embedding',
+        dimension: 1536,
+      },
+    },
+  });
+  ```
+
+- Added `ConvexServerCache` so Convex-backed Mastra apps can keep durable stream replay and response cache state in Convex. ([#16736](https://github.com/mastra-ai/mastra/pull/16736))
+
+  ```ts
+  import { ConvexServerCache } from '@mastra/convex';
+
+  const cache = new ConvexServerCache({
+    deploymentUrl: process.env.CONVEX_URL!,
+    adminAuthToken: process.env.CONVEX_ADMIN_KEY!,
+  });
+  ```
+
+  The package also exports the Convex cache schema tables and server mutation for mounting the cache handler in a Convex app.
+  Existing Convex users who adopt the cache must add `mastra_cache` and `mastra_cache_list_items` to their Convex schema, mount the `mastraCache` handler, and deploy the schema update.
+
+### Patch Changes
+
+- Updated dependencies [[`452036a`](https://github.com/mastra-ai/mastra/commit/452036a0d965b4f4c1efd93606e4f03b50b807a5), [`c272d50`](https://github.com/mastra-ai/mastra/commit/c272d50610a54496b6b6d92ccd4d37b333a2613a), [`27fd1b7`](https://github.com/mastra-ai/mastra/commit/27fd1b79ac62eb7694f92587eb7d1be05b59be01), [`5ba7253`](https://github.com/mastra-ai/mastra/commit/5ba7253745c85e8df8012a76d954c640ffa336f7), [`5556cc1`](https://github.com/mastra-ai/mastra/commit/5556cc1befec71518d84f826b3bfe3a079a9daf7), [`f73980d`](https://github.com/mastra-ai/mastra/commit/f73980d651eb5f7f1ab20582de4615a1b6f10fce), [`5499303`](https://github.com/mastra-ai/mastra/commit/54993032c1ebc09642625b78d2014e0cf84a3cae), [`a702009`](https://github.com/mastra-ai/mastra/commit/a702009d3cfaa745120f501e21c783ed4d6a3072), [`9aee493`](https://github.com/mastra-ai/mastra/commit/9aee493ed6089b5133472623dcce49934bf2d509), [`d8692af`](https://github.com/mastra-ai/mastra/commit/d8692afa253028e39cdce2aafa0ac414071a762e), [`1a9cc60`](https://github.com/mastra-ai/mastra/commit/1a9cc6069f9910fc3d59e4953ac8cd95d89ad6f5), [`8cdb86c`](https://github.com/mastra-ai/mastra/commit/8cdb86ceed1137bc2768e147dce85a0692b9fb26), [`8534d79`](https://github.com/mastra-ai/mastra/commit/8534d791fa1cb70fe1c19e2604c4b63cc10dd051), [`eda90c5`](https://github.com/mastra-ai/mastra/commit/eda90c5bfd7de11805ecc9f4552716c895fbaf78), [`a935b0a`](https://github.com/mastra-ai/mastra/commit/a935b0a0977ae3f196b33ec7621f528069c82db0), [`9c88701`](https://github.com/mastra-ai/mastra/commit/9c8870195b41a38dc40b6ba2aa55eda04df8fa69), [`c78f8cd`](https://github.com/mastra-ai/mastra/commit/c78f8cd6222a86e6c60ae5210b6929ad5221b6fb), [`e146aad`](https://github.com/mastra-ai/mastra/commit/e146aadbba66c410ba0e74bac4c50135495cb8dd), [`ac79462`](https://github.com/mastra-ai/mastra/commit/ac79462b98f1062394c45093aa515b0766f27ee2), [`1a0ec78`](https://github.com/mastra-ai/mastra/commit/1a0ec789a26cae443744e9abbd62ed6ee676af39), [`e47bca7`](https://github.com/mastra-ai/mastra/commit/e47bca7b72866d3abd173b9f530ac4318113a8ff), [`afc004f`](https://github.com/mastra-ai/mastra/commit/afc004f5cc7e30697809e7021820b9f5881e6719), [`0031d0f`](https://github.com/mastra-ai/mastra/commit/0031d0f13831d7843ac5d498734a7d92862e2ce3), [`841a222`](https://github.com/mastra-ai/mastra/commit/841a222560d8c19238f8213713f30535cdd82284), [`64c1e0b`](https://github.com/mastra-ai/mastra/commit/64c1e0b35165c96b659818bd0177aa18794ef11f), [`40d83a9`](https://github.com/mastra-ai/mastra/commit/40d83a90d9be31a1b83e04649edb703eb7753e33), [`4e88dc6`](https://github.com/mastra-ai/mastra/commit/4e88dc6b89f154c0eae37221c8126be0c23c569f), [`19018f0`](https://github.com/mastra-ai/mastra/commit/19018f05722af74a5978781a7731a654b26f7f2a), [`19281c7`](https://github.com/mastra-ai/mastra/commit/19281c70424f757219782de16c2699743c5e04d0), [`3498b49`](https://github.com/mastra-ai/mastra/commit/3498b4946be94f4313cd817733589680dcda5278), [`d52b6fe`](https://github.com/mastra-ai/mastra/commit/d52b6fe1c56853eb38864baae0bbfa75cc739ccb), [`408be73`](https://github.com/mastra-ai/mastra/commit/408be73449dfab92b51eab8c6623b6c443debc25), [`359439b`](https://github.com/mastra-ai/mastra/commit/359439bb8c635e048176306828195f8297f50021), [`71a820b`](https://github.com/mastra-ai/mastra/commit/71a820b2353fa1406772c50760a3732058a8b337), [`1698f5e`](https://github.com/mastra-ai/mastra/commit/1698f5ec141d34f22a873efdb145ce3cdf848a5e)]:
+  - @mastra/core@1.36.0
+
 ## 1.1.0-alpha.0
 
 ### Minor Changes

package/README.md

@@ -2,7 +2,7 @@
 
 Convex adapters for Mastra:
 
-- `ConvexStore` implements the Mastra storage contract (threads, messages, workflows, scores, resources).
+- `ConvexStore` implements the Mastra storage contract (threads, messages, workflows, scores, resources, schedules, channels, background tasks).
 - `ConvexVector` stores embeddings inside Convex and performs development-scale cosine similarity search.
 - `ConvexNativeVector` uses Convex native vector search for production workloads.
 - `ConvexServerCache` stores Mastra server cache entries in Convex for durable stream replay and response caching.
@@ -28,6 +28,11 @@ import {
   mastraResourcesTable,
   mastraWorkflowSnapshotsTable,
   mastraScoresTable,
+  mastraSchedulesTable,
+  mastraScheduleTriggersTable,
+  mastraChannelInstallationsTable,
+  mastraChannelConfigTable,
+  mastraBackgroundTasksTable,
   mastraVectorIndexesTable,
   mastraVectorsTable,
   mastraCacheTable,
@@ -41,6 +46,11 @@ export default defineSchema({
   mastra_resources: mastraResourcesTable,
   mastra_workflow_snapshots: mastraWorkflowSnapshotsTable,
   mastra_scorers: mastraScoresTable,
+  mastra_schedules: mastraSchedulesTable,
+  mastra_schedule_triggers: mastraScheduleTriggersTable,
+  mastra_channel_installations: mastraChannelInstallationsTable,
+  mastra_channel_config: mastraChannelConfigTable,
+  mastra_background_tasks: mastraBackgroundTasksTable,
   mastra_vector_indexes: mastraVectorIndexesTable,
   mastra_vectors: mastraVectorsTable,
   mastra_cache: mastraCacheTable,
@@ -160,24 +170,32 @@ Native vector search uses Convex's schema-defined vector indexes and action-only
 
 This adapter uses **typed Convex tables** for each Mastra domain:
 
-| Domain         | Convex Table                | Purpose              |
-| -------------- | --------------------------- | -------------------- |
-| Threads        | `mastra_threads`            | Conversation threads |
-| Messages       | `mastra_messages`           | Chat messages        |
-| Resources      | `mastra_resources`          | User working memory  |
-| Workflows      | `mastra_workflow_snapshots` | Workflow state       |
-| Scorers        | `mastra_scorers`            | Evaluation data      |
-| Vector Indexes | `mastra_vector_indexes`     | Index metadata       |
-| Vectors        | `mastra_vectors`            | Embeddings           |
-| Cache          | `mastra_cache`              | Cache metadata       |
-| Cache Items    | `mastra_cache_list_items`   | Cache list entries   |
-| Fallback       | `mastra_documents`          | Unknown tables       |
+| Domain           | Convex Table                                            | Purpose                          |
+| ---------------- | ------------------------------------------------------- | -------------------------------- |
+| Threads          | `mastra_threads`                                        | Conversation threads             |
+| Messages         | `mastra_messages`                                       | Chat messages                    |
+| Resources        | `mastra_resources`                                      | User working memory              |
+| Workflows        | `mastra_workflow_snapshots`                             | Workflow state                   |
+| Scorers          | `mastra_scorers`                                        | Evaluation data                  |
+| Schedules        | `mastra_schedules`                                      | Workflow schedules               |
+| Triggers         | `mastra_schedule_triggers`                              | Schedule history                 |
+| Channels         | `mastra_channel_installations`, `mastra_channel_config` | Channel installations and config |
+| Background Tasks | `mastra_background_tasks`                               | Background task state            |
+| Vector Indexes   | `mastra_vector_indexes`                                 | Index metadata                   |
+| Vectors          | `mastra_vectors`                                        | Embeddings                       |
+| Cache            | `mastra_cache`                                          | Cache metadata                   |
+| Cache Items      | `mastra_cache_list_items`                               | Cache list entries               |
+| Fallback         | `mastra_documents`                                      | Unknown tables                   |
 
 All typed tables include:
 
 - An `id` field for Mastra's record ID (distinct from Convex's auto-generated `_id`)
 - A `by_record_id` index for efficient lookups by Mastra ID
 
+Schedule due reads and trigger-history reads use bounded Convex queries to avoid deployment read limits. When no explicit trigger-history limit is provided, the adapter returns the newest 100 rows. Schedule listing is capped at 8,000 rows per call. Schedule rows also store a normalized `workflow_id` alongside the serialized target so workflow filters can run inside Convex before the listing cap is applied.
+
+Background task reads and updates also tolerate older rows that were written to the fallback `mastra_documents` table.
+
 ## Testing
 
 Set the following environment variables before running tests: