@mastra/libsql 1.20.0 → 1.20.1-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/dist/docs/SKILL.md +6 -9
  3. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  4. package/dist/docs/references/{docs-agents-agent-approval.md → docs-agents-human-in-the-loop.md} +11 -9
  5. package/dist/docs/references/docs-agents-networks.md +3 -3
  6. package/dist/docs/references/docs-deployment-workers.md +253 -7
  7. package/dist/docs/references/docs-memory-memory-processors.md +1 -1
  8. package/dist/docs/references/docs-memory-message-history.md +3 -3
  9. package/dist/docs/references/docs-memory-overview.md +4 -4
  10. package/dist/docs/references/docs-memory-semantic-recall.md +1 -1
  11. package/dist/docs/references/docs-memory-working-memory.md +3 -3
  12. package/dist/docs/references/{docs-storage-overview.md → docs-storage.md} +8 -7
  13. package/dist/docs/references/{docs-editor-overview.md → docs-studio-editor.md} +3 -1
  14. package/dist/docs/references/docs-workflows-snapshots.md +1 -1
  15. package/dist/docs/references/integrations-channels-github.md +1 -1
  16. package/dist/docs/references/{guides-agent-frameworks-ai-sdk.md → reference-ai-sdk-overview.md} +1 -1
  17. package/dist/docs/references/reference-core-mastra-class.md +1 -1
  18. package/dist/docs/references/reference-file-based-agents-memory.md +2 -2
  19. package/dist/docs/references/reference-file-based-agents-storage.md +3 -3
  20. package/dist/docs/references/reference-memory-memory-class.md +1 -0
  21. package/dist/docs/references/reference-storage-retention.md +1 -1
  22. package/dist/index.cjs +3 -0
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.js +3 -0
  25. package/dist/index.js.map +1 -1
  26. package/dist/storage/domains/agents/index.d.ts.map +1 -1
  27. package/package.json +5 -5
@@ -147,7 +147,7 @@ export const mastra = new Mastra({
147
147
  - [Upstash Storage](https://mastra.ai/integrations/databases/upstash)
148
148
  - [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
149
149
  - [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
150
- - [More storage providers](https://mastra.ai/docs/storage/overview)
150
+ - [More storage providers](https://mastra.ai/docs/storage)
151
151
 
152
152
  ## Best practices
153
153
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # GitHub
4
4
 
5
- The `@mastra/github-signals` provider lets an agent follow pull requests (PRs). It polls subscribed PRs and sends [notification signals](https://mastra.ai/docs/long-running-agents/signals) to the agent thread when relevant activity occurs.
5
+ The `@mastra/github-signals` provider lets an agent follow pull requests (PRs). It polls subscribed PRs and sends [notification signals](https://mastra.ai/docs/harness/signals) to the agent thread when relevant activity occurs.
6
6
 
7
7
  ## Installation
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # AI SDK
4
4
 
5
- If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing, conversation persistence, or content filtering.
5
+ If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing and conversation persistence, including content filtering.
6
6
 
7
7
  > **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
8
8
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  The `Mastra` class is the central orchestrator in any Mastra application, managing agents, workflows, storage, logging, observability, and more. Typically, you create a single instance of `Mastra` to coordinate your application.
6
6
 
7
- Think of `Mastra` as a top-level registry where you register agents, workflows, tools, and other components that need to be accessible throughout your application.
7
+ `Mastra` is the top-level registry where you register agents, workflows, tools, and other components that need to be accessible throughout your application.
8
8
 
9
9
  ## Usage example
10
10
 
@@ -18,7 +18,7 @@ import { Memory } from '@mastra/memory'
18
18
  export default new Memory()
19
19
  ```
20
20
 
21
- The exported instance becomes the agent's `memory`. If your app configures a storage provider on the main Mastra instance, memory data is stored there. See [storage](https://mastra.ai/docs/storage/overview) for more information.
21
+ The exported instance becomes the agent's `memory`. If your app configures a storage provider on the main Mastra instance, memory data is stored there. See [storage](https://mastra.ai/docs/storage) for more information.
22
22
 
23
23
  Use the same `resource` and `thread` values when calling the agent to continue a conversation:
24
24
 
@@ -51,7 +51,7 @@ export default new Memory({
51
51
 
52
52
  Visit the [`Memory` reference](https://mastra.ai/reference/memory/memory-class) for constructor options. Use these pages for related memory features:
53
53
 
54
- - [Storage](https://mastra.ai/docs/storage/overview): configure persistence for memory data.
54
+ - [Storage](https://mastra.ai/docs/storage): configure persistence for memory data.
55
55
  - [Semantic recall](https://mastra.ai/docs/memory/semantic-recall): retrieve relevant past messages by semantic meaning.
56
56
  - [Memory processors](https://mastra.ai/docs/memory/memory-processors): filter, trim, or transform messages before memory adds them to model context.
57
57
 
@@ -4,9 +4,9 @@
4
4
 
5
5
  > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
6
6
 
7
- Mastra sets the project's default [storage](https://mastra.ai/docs/storage/overview) from a `storage.ts` file directly under `src/mastra/`. The file default-exports a store, which replaces the built-in in-memory store used for memory, workflows, observability, and other storage domains.
7
+ Mastra sets the project's default [storage](https://mastra.ai/docs/storage) from a `storage.ts` file directly under `src/mastra/`. The file default-exports a store, which replaces the built-in in-memory store used for memory, workflows, observability, and other storage domains.
8
8
 
9
- Use this page for the file-based convention. For backend choice, storage domains, retention, and provider details, see [storage overview](https://mastra.ai/docs/storage/overview).
9
+ Use this page for the file-based convention. For backend choice, storage domains, retention, and provider details, see [storage overview](https://mastra.ai/docs/storage).
10
10
 
11
11
  ## Quickstart
12
12
 
@@ -25,7 +25,7 @@ Mastra registers the store before file-based agents and workflows, so storage-de
25
25
 
26
26
  ## Production backends
27
27
 
28
- `storage.ts` can export any Mastra storage adapter, such as LibSQL, PostgreSQL, or MongoDB. For setup patterns, provider support, and schema details, see [storage overview](https://mastra.ai/docs/storage/overview), [observability signal support](https://mastra.ai/docs/observability/overview), and the [storage reference](https://mastra.ai/reference/storage/overview).
28
+ `storage.ts` can export any Mastra storage adapter, such as LibSQL, PostgreSQL, or MongoDB. For setup patterns, provider support, and schema details, see [storage overview](https://mastra.ai/docs/storage), [observability signal support](https://mastra.ai/docs/observability/overview), and the [storage reference](https://mastra.ai/reference/storage/overview).
29
29
 
30
30
  ## Precedence with code
31
31
 
@@ -145,4 +145,5 @@ export const agent = new Agent({
145
145
  - [listThreads](https://mastra.ai/reference/memory/listThreads)
146
146
  - [deleteMessages](https://mastra.ai/reference/memory/deleteMessages)
147
147
  - [cloneThread](https://mastra.ai/reference/memory/cloneThread)
148
+ - [settled](https://mastra.ai/reference/memory/settled)
148
149
  - [Clone Utility Methods](https://mastra.ai/reference/memory/clone-utilities)
@@ -234,7 +234,7 @@ const storage = new MongoDBStore({
234
234
 
235
235
  `prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist and are reused by future writes, so the file stops growing: for most users this alone solves the unbounded-growth problem.
236
236
 
237
- Handing that free space back to the OS is a separate concern that Mastra doesn't manage. If you specifically need to shrink the file, run the underlying database's compaction (for example `VACUUM` on self-hosted libSQL) yourself in a maintenance window. A full `VACUUM` locks the file and needs roughly twice the file size in free disk. On PostgreSQL, autovacuum reclaims dead tuples for reuse automatically; a manual `VACUUM FULL` is only needed if you must return disk to the OS.
237
+ Handing that free space back to the OS is a separate concern that Mastra doesn't manage. If you specifically need to shrink the file, run the underlying database's compaction (for example `VACUUM` on self-hosted libSQL) yourself in a maintenance window. A full `VACUUM` locks the file and needs roughly twice the file size in free disk. On PostgreSQL, autovacuum reclaims dead tuples for reuse automatically. A manual `VACUUM FULL` is only needed if you must return disk to the OS.
238
238
 
239
239
  For MongoDB, deleted documents are reused by future insertions. To reclaim disk space, run [`db.runCommand({ compact: "collection_name" })`](https://www.mongodb.com/docs/manual/reference/command/compact/) during a maintenance window.
240
240
 
package/dist/index.cjs CHANGED
@@ -2021,6 +2021,7 @@ var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
2021
2021
  "workspace",
2022
2022
  "skills",
2023
2023
  "skillsFormat",
2024
+ "durable",
2024
2025
  "browser",
2025
2026
  "toolProviders"
2026
2027
  ]
@@ -2456,6 +2457,7 @@ var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
2456
2457
  workspace: input.workspace ?? null,
2457
2458
  skills: input.skills ?? null,
2458
2459
  skillsFormat: input.skillsFormat ?? null,
2460
+ durable: input.durable ?? null,
2459
2461
  browser: input.browser ?? null,
2460
2462
  changedFields: input.changedFields ?? null,
2461
2463
  changeMessage: input.changeMessage ?? null,
@@ -2691,6 +2693,7 @@ var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
2691
2693
  workspace: this.parseJson(row.workspace, "workspace"),
2692
2694
  skills: this.parseJson(row.skills, "skills"),
2693
2695
  skillsFormat: row.skillsFormat,
2696
+ durable: this.parseJson(row.durable, "durable"),
2694
2697
  browser: this.parseJson(row.browser, "browser"),
2695
2698
  changedFields: this.parseJson(row.changedFields, "changedFields"),
2696
2699
  changeMessage: row.changeMessage,