@mastra/libsql 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

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 (77) hide show
  1. package/CHANGELOG.md +2839 -3
  2. package/LICENSE.md +15 -0
  3. package/README.md +30 -20
  4. package/dist/docs/SKILL.md +50 -0
  5. package/dist/docs/assets/SOURCE_MAP.json +6 -0
  6. package/dist/docs/references/docs-agents-agent-approval.md +588 -0
  7. package/dist/docs/references/docs-agents-agent-memory.md +209 -0
  8. package/dist/docs/references/docs-agents-network-approval.md +275 -0
  9. package/dist/docs/references/docs-agents-networks.md +299 -0
  10. package/dist/docs/references/docs-memory-memory-processors.md +314 -0
  11. package/dist/docs/references/docs-memory-message-history.md +260 -0
  12. package/dist/docs/references/docs-memory-overview.md +45 -0
  13. package/dist/docs/references/docs-memory-semantic-recall.md +288 -0
  14. package/dist/docs/references/docs-memory-storage.md +261 -0
  15. package/dist/docs/references/docs-memory-working-memory.md +400 -0
  16. package/dist/docs/references/docs-observability-overview.md +70 -0
  17. package/dist/docs/references/docs-observability-tracing-exporters-default.md +209 -0
  18. package/dist/docs/references/docs-rag-retrieval.md +515 -0
  19. package/dist/docs/references/docs-workflows-snapshots.md +238 -0
  20. package/dist/docs/references/guides-agent-frameworks-ai-sdk.md +140 -0
  21. package/dist/docs/references/reference-core-getMemory.md +50 -0
  22. package/dist/docs/references/reference-core-listMemory.md +56 -0
  23. package/dist/docs/references/reference-core-mastra-class.md +66 -0
  24. package/dist/docs/references/reference-memory-memory-class.md +147 -0
  25. package/dist/docs/references/reference-storage-composite.md +235 -0
  26. package/dist/docs/references/reference-storage-dynamodb.md +282 -0
  27. package/dist/docs/references/reference-storage-libsql.md +135 -0
  28. package/dist/docs/references/reference-vectors-libsql.md +305 -0
  29. package/dist/index.cjs +8693 -1962
  30. package/dist/index.cjs.map +1 -1
  31. package/dist/index.js +8682 -1965
  32. package/dist/index.js.map +1 -1
  33. package/dist/storage/db/index.d.ts +306 -0
  34. package/dist/storage/db/index.d.ts.map +1 -0
  35. package/dist/storage/{domains → db}/utils.d.ts +21 -13
  36. package/dist/storage/db/utils.d.ts.map +1 -0
  37. package/dist/storage/domains/agents/index.d.ts +30 -0
  38. package/dist/storage/domains/agents/index.d.ts.map +1 -0
  39. package/dist/storage/domains/blobs/index.d.ts +17 -0
  40. package/dist/storage/domains/blobs/index.d.ts.map +1 -0
  41. package/dist/storage/domains/datasets/index.d.ts +43 -0
  42. package/dist/storage/domains/datasets/index.d.ts.map +1 -0
  43. package/dist/storage/domains/experiments/index.d.ts +29 -0
  44. package/dist/storage/domains/experiments/index.d.ts.map +1 -0
  45. package/dist/storage/domains/mcp-clients/index.d.ts +26 -0
  46. package/dist/storage/domains/mcp-clients/index.d.ts.map +1 -0
  47. package/dist/storage/domains/mcp-servers/index.d.ts +26 -0
  48. package/dist/storage/domains/mcp-servers/index.d.ts.map +1 -0
  49. package/dist/storage/domains/memory/index.d.ts +40 -53
  50. package/dist/storage/domains/memory/index.d.ts.map +1 -1
  51. package/dist/storage/domains/observability/index.d.ts +41 -29
  52. package/dist/storage/domains/observability/index.d.ts.map +1 -1
  53. package/dist/storage/domains/prompt-blocks/index.d.ts +25 -0
  54. package/dist/storage/domains/prompt-blocks/index.d.ts.map +1 -0
  55. package/dist/storage/domains/scorer-definitions/index.d.ts +26 -0
  56. package/dist/storage/domains/scorer-definitions/index.d.ts.map +1 -0
  57. package/dist/storage/domains/scores/index.d.ts +19 -31
  58. package/dist/storage/domains/scores/index.d.ts.map +1 -1
  59. package/dist/storage/domains/skills/index.d.ts +26 -0
  60. package/dist/storage/domains/skills/index.d.ts.map +1 -0
  61. package/dist/storage/domains/workflows/index.d.ts +20 -32
  62. package/dist/storage/domains/workflows/index.d.ts.map +1 -1
  63. package/dist/storage/domains/workspaces/index.d.ts +26 -0
  64. package/dist/storage/domains/workspaces/index.d.ts.map +1 -0
  65. package/dist/storage/index.d.ts +68 -259
  66. package/dist/storage/index.d.ts.map +1 -1
  67. package/dist/vector/index.d.ts +12 -4
  68. package/dist/vector/index.d.ts.map +1 -1
  69. package/dist/vector/sql-builder.d.ts.map +1 -1
  70. package/package.json +16 -12
  71. package/dist/storage/domains/legacy-evals/index.d.ts +0 -18
  72. package/dist/storage/domains/legacy-evals/index.d.ts.map +0 -1
  73. package/dist/storage/domains/operations/index.d.ts +0 -110
  74. package/dist/storage/domains/operations/index.d.ts.map +0 -1
  75. package/dist/storage/domains/traces/index.d.ts +0 -21
  76. package/dist/storage/domains/traces/index.d.ts.map +0 -1
  77. package/dist/storage/domains/utils.d.ts.map +0 -1
package/LICENSE.md CHANGED
@@ -1,3 +1,18 @@
1
+ Portions of this software are licensed as follows:
2
+
3
+ - All content that resides under any directory named "ee/" within this
4
+ repository, including but not limited to:
5
+ - `packages/core/src/auth/ee/`
6
+ - `packages/server/src/server/auth/ee/`
7
+ is licensed under the license defined in `ee/LICENSE`.
8
+
9
+ - All third-party components incorporated into the Mastra Software are
10
+ licensed under the original license provided by the owner of the
11
+ applicable component.
12
+
13
+ - Content outside of the above-mentioned directories or restrictions is
14
+ available under the "Apache License 2.0" as defined below.
15
+
1
16
  # Apache License 2.0
2
17
 
3
18
  Copyright (c) 2025 Kepler Software, Inc.
package/README.md CHANGED
@@ -50,31 +50,38 @@ const results = await vectorStore.query({
50
50
  import { LibSQLStore } from '@mastra/libsql';
51
51
 
52
52
  const store = new LibSQLStore({
53
+ id: 'libsql-storage',
53
54
  url: 'file:./my-db.db',
54
55
  });
55
56
 
56
57
  // Create a thread
57
58
  await store.saveThread({
58
- id: 'thread-123',
59
- resourceId: 'resource-456',
60
- title: 'My Thread',
61
- metadata: { key: 'value' },
59
+ thread: {
60
+ id: 'thread-123',
61
+ resourceId: 'resource-456',
62
+ title: 'My Thread',
63
+ metadata: { key: 'value' },
64
+ createdAt: new Date(),
65
+ },
62
66
  });
63
67
 
64
68
  // Add messages to thread
65
- await store.saveMessages([
66
- {
67
- id: 'msg-789',
68
- threadId: 'thread-123',
69
- role: 'user',
70
- type: 'text',
71
- content: [{ type: 'text', text: 'Hello' }],
72
- },
73
- ]);
69
+ await store.saveMessages({
70
+ messages: [
71
+ {
72
+ id: 'msg-789',
73
+ threadId: 'thread-123',
74
+ role: 'user',
75
+ content: { content: 'Hello' },
76
+ resourceId: 'resource-456',
77
+ createdAt: new Date(),
78
+ },
79
+ ],
80
+ });
74
81
 
75
82
  // Query threads and messages
76
- const savedThread = await store.getThread('thread-123');
77
- const messages = await store.getMessages('thread-123');
83
+ const savedThread = await store.getThreadById({ threadId: 'thread-123' });
84
+ const messages = await store.listMessages({ threadId: 'thread-123' });
78
85
  ```
79
86
 
80
87
  ## Configuration
@@ -124,6 +131,9 @@ Example filter:
124
131
  - `createIndex({indexName, dimension, metric?, indexConfig?, defineIndex?})`: Create a new table with vector support
125
132
  - `upsert({indexName, vectors, metadata?, ids?})`: Add or update vectors
126
133
  - `query({indexName, queryVector, topK?, filter?, includeVector?, minScore?})`: Search for similar vectors
134
+ - `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
135
+ - `deleteVector({ indexName, id })`: Delete a single vector by ID
136
+ - `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
127
137
  - `defineIndex({indexName, metric?, indexConfig?})`: Define an index
128
138
  - `listIndexes()`: List all vector-enabled tables
129
139
  - `describeIndex(indexName)`: Get table statistics
@@ -132,11 +142,11 @@ Example filter:
132
142
 
133
143
  ## Storage Methods
134
144
 
135
- - `saveThread(thread)`: Create or update a thread
136
- - `getThread(threadId)`: Get a thread by ID
137
- - `deleteThread(threadId)`: Delete a thread and its messages
138
- - `saveMessages(messages)`: Save multiple messages in a transaction
139
- - `getMessages(threadId)`: Get all messages for a thread
145
+ - `saveThread({ thread })`: Create or update a thread
146
+ - `getThreadById({ threadId })`: Get a thread by ID
147
+ - `deleteThread({ threadId })`: Delete a thread and its messages
148
+ - `saveMessages({ messages })`: Save multiple messages in a transaction
149
+ - `listMessages({ threadId, perPage?, page? })`: Get messages for a thread with pagination
140
150
  - `deleteMessages(messageIds)`: Delete specific messages
141
151
 
142
152
  ## Related Links
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: mastra-libsql
3
+ description: Documentation for @mastra/libsql. Use when working with @mastra/libsql APIs, configuration, or implementation.
4
+ metadata:
5
+ package: "@mastra/libsql"
6
+ version: "0.0.0-execa-dynamic-import-20260304221256"
7
+ ---
8
+
9
+ ## When to use
10
+
11
+ Use this skill whenever you are working with @mastra/libsql to obtain the domain-specific knowledge.
12
+
13
+ ## How to use
14
+
15
+ Read the individual reference documents for detailed explanations and code examples.
16
+
17
+ ### Docs
18
+
19
+ - [Agent Approval](references/docs-agents-agent-approval.md) - Learn how to require approvals, suspend tool execution, and automatically resume suspended tools while keeping humans in control of agent workflows.
20
+ - [Agent Memory](references/docs-agents-agent-memory.md) - Learn how to add memory to agents to store message history and maintain context across interactions.
21
+ - [Network Approval](references/docs-agents-network-approval.md) - Learn how to require approvals, suspend execution, and resume suspended networks while keeping humans in control of agent network workflows.
22
+ - [Agent Networks](references/docs-agents-networks.md) - Learn how to coordinate multiple agents, workflows, and tools using agent networks for complex, non-deterministic task execution.
23
+ - [Memory Processors](references/docs-memory-memory-processors.md) - Learn how to use memory processors in Mastra to filter, trim, and transform messages before they're sent to the language model to manage context window limits.
24
+ - [Message History](references/docs-memory-message-history.md) - Learn how to configure message history in Mastra to store recent messages from the current conversation.
25
+ - [Memory overview](references/docs-memory-overview.md) - Learn how Mastra's memory system works with working memory, message history, semantic recall, and observational memory.
26
+ - [Semantic Recall](references/docs-memory-semantic-recall.md) - Learn how to use semantic recall in Mastra to retrieve relevant messages from past conversations using vector search and embeddings.
27
+ - [Storage](references/docs-memory-storage.md) - Configure storage for Mastra's memory system to persist conversations, workflows, and traces.
28
+ - [Working Memory](references/docs-memory-working-memory.md) - Learn how to configure working memory in Mastra to store persistent user data, preferences.
29
+ - [Observability Overview](references/docs-observability-overview.md) - Monitor and debug applications with Mastra's Observability features.
30
+ - [Default Exporter](references/docs-observability-tracing-exporters-default.md) - Store traces locally for development and debugging
31
+ - [Retrieval, Semantic Search, Reranking](references/docs-rag-retrieval.md) - Guide on retrieval processes in Mastra's RAG systems, including semantic search, filtering, and re-ranking.
32
+ - [Snapshots](references/docs-workflows-snapshots.md) - Learn how to save and resume workflow execution state with snapshots in Mastra
33
+
34
+ ### Guides
35
+
36
+ - [AI SDK](references/guides-agent-frameworks-ai-sdk.md) - Use Mastra processors and memory with the Vercel AI SDK
37
+
38
+ ### Reference
39
+
40
+ - [Reference: Mastra.getMemory()](references/reference-core-getMemory.md) - Documentation for the `Mastra.getMemory()` method in Mastra, which retrieves a registered memory instance by its registry key.
41
+ - [Reference: Mastra.listMemory()](references/reference-core-listMemory.md) - Documentation for the `Mastra.listMemory()` method in Mastra, which returns all registered memory instances.
42
+ - [Reference: Mastra Class](references/reference-core-mastra-class.md) - Documentation for the `Mastra` class in Mastra, the core entry point for managing agents, workflows, MCP servers, and server endpoints.
43
+ - [Reference: Memory Class](references/reference-memory-memory-class.md) - Documentation for the `Memory` class in Mastra, which provides a robust system for managing conversation history and thread-based message storage.
44
+ - [Reference: Composite Storage](references/reference-storage-composite.md) - Documentation for combining multiple storage backends in Mastra.
45
+ - [Reference: DynamoDB Storage](references/reference-storage-dynamodb.md) - Documentation for the DynamoDB storage implementation in Mastra, using a single-table design with ElectroDB.
46
+ - [Reference: libSQL Storage](references/reference-storage-libsql.md) - Documentation for the libSQL storage implementation in Mastra.
47
+ - [Reference: libSQL Vector Store](references/reference-vectors-libsql.md) - Documentation for the LibSQLVector class in Mastra, which provides vector search using libSQL with vector extensions.
48
+
49
+
50
+ Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": "0.0.0-execa-dynamic-import-20260304221256",
3
+ "package": "@mastra/libsql",
4
+ "exports": {},
5
+ "modules": {}
6
+ }