@mastra/libsql 1.29.0-alpha.2 → 1.30.0-alpha.0

package/dist/docs/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: mastra-libsql
+description: Documentation for @mastra/libsql. Use when working with @mastra/libsql APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/libsql"
+  version: "1.30.0-alpha.0"
+---
+
+## When to use
+
+Use this skill whenever you are working with @mastra/libsql to obtain the domain-specific knowledge.
+
+## How to use
+
+Read the individual reference documents for detailed explanations and code examples.
+
+### Docs
+
+- [Human-in-the-loop](references/docs-agents-human-in-the-loop.md) - Add human-in-the-loop controls to Mastra agents with tool approval and suspended execution, so people can provide input before a run resumes or stops.
+- [Agent networks](references/docs-agents-networks.md) - Understand deprecated Mastra agent networks, including multi-agent routing, structured output, tool approvals, and migration to supervisor agents.
+- [Workers](references/docs-deployment-workers.md) - Run Mastra workflow orchestration, schedules, and long-running background tasks in dedicated workers to keep API processes responsive under load.
+- [Load your content](references/docs-knowledge-load-your-content.md) - Load your own content, such as product docs or policies, into Knowledge so agents can search and read it.
+- [Knowledge](references/docs-knowledge-overview.md) - Give agents shared pages and notes they search, read and write, with access decided by your configuration rather than by the model.
+- [Search](references/docs-knowledge-search.md) - How Knowledge search ranks results, and how to add search by meaning.
+- [Memory processors](references/docs-memory-memory-processors.md) - Configure Mastra memory processors to filter, trim, transform, and deduplicate messages before they reach the model while managing context limits.
+- [Message history](references/docs-memory-message-history.md) - Store and retrieve recent Mastra conversation messages, configure history limits and thread titles, and query threads for chat interfaces.
+- [Multi-user threads](references/docs-memory-multi-user-threads.md) - Share one Mastra memory thread across multiple users by preserving speaker identity in messages and combining history with observational or working memory.
+- [Memory](references/docs-memory-overview.md) - Add memory to Mastra agents with message history, observational memory, and working memory across threads and multi-agent delegation.
+- [Semantic recall](references/docs-memory-semantic-recall.md) - Retrieve relevant messages from past Mastra conversations with semantic recall, vector search, embeddings, metadata filters, and configurable storage.
+- [Working memory](references/docs-memory-working-memory.md) - Persist user profiles, preferences, and application data with Mastra working memory using resource- or thread-scoped templates and storage adapters.
+- [Signals](references/docs-signals-overview.md) - Send asynchronous input into a Mastra agent thread while Mastra manages whether the agent is active or idle.
+- [Storage](references/docs-storage.md) - Configure Mastra storage to persist memory, workflow state, observability data, evals, schedules, and long-running agent state across restarts.
+- [Editor](references/docs-studio-editor.md) - Use Mastra Studio Editor so collaborators can change agent instructions and tools without modifying source code, from draft testing through publication.
+- [Snapshots](references/docs-workflows-snapshots.md) - Store and retrieve Mastra workflow snapshots so suspended executions preserve step results and state and can resume reliably across processes.
+
+### Integrations
+
+- [GitHub](references/integrations-channels-github.md) - Subscribe Mastra agents to GitHub pull requests with @mastra/github-signals, polling modes, notification signals, and subscription management tools.
+- [Ring](references/integrations-channels-ring.md) - Send Ring doorbell and camera events to Mastra agents as notification signals with @mastra/ring-signals, and fetch snapshots and video clips with agent tools.
+- [DynamoDB](references/integrations-databases-dynamodb.md) - Persist Mastra data in Amazon DynamoDB with a single-table ElectroDB design, configurable indexes, TTL support, credentials, and table initialization.
+- [libSQL](references/integrations-databases-libsql.md) - Persist Mastra messages, workflow snapshots, traces, and eval scores in local or remote libSQL with managed tables and initialization options.
+- [libSQL](references/integrations-vectors-libsql.md) - Store embeddings in a local libSQL database or Turso and run similarity search with metadata filtering from Mastra.
+
+### Reference
+
+- [AI SDK overview](references/reference-ai-sdk-overview.md) - Wrap Vercel AI SDK models with Mastra processors and memory using withMastra(), while retaining existing AI SDK generation, streaming, and UI integrations.
+- [Reference: Mastra.getMemory()](references/reference-core-getMemory.md) - The .getMemory() method retrieves a memory instance from the Mastra registry by its key.
+- [Reference: Mastra.listMemory()](references/reference-core-listMemory.md) - The .listMemory() method returns all memory instances registered with the Mastra instance.
+- [Reference: Mastra class](references/reference-core-mastra-class.md) - The Mastra class is the central orchestrator in any Mastra application, managing agents, workflows, storage, logging, observability, and more.
+- [Memory](references/reference-file-based-agents-memory.md) - A file-based agent gets memory from a memory.ts file that default-exports a Memory instance.
+- [Storage](references/reference-file-based-agents-storage.md) - Mastra sets the project's default storage from a storage.ts file directly under src/mastra/.
+- [Reference: Memory class](references/reference-memory-memory-class.md) - The Memory class provides a reliable system for managing conversation history and thread-based message storage in Mastra.
+- [Retrieval, semantic search, reranking](references/reference-rag-retrieval.md) - After storing embeddings, you need to retrieve relevant chunks to answer user queries.
+- [Reference: Composite storage](references/reference-storage-composite.md) - MastraCompositeStore can compose storage domains from different providers. Use it when you need different databases for different purposes.
+- [Reference: Storage retention (prune)](references/reference-storage-retention.md) - prune() deletes rows. It caps growth and is safe to run against large tables (batched, bounded, resumable, cancellable).
+
+
+Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -0,0 +1,152 @@
+{
+  "version": "1.30.0-alpha.0",
+  "package": "@mastra/libsql",
+  "exports": {
+    "AgentsLibSQL": {
+      "types": "dist/storage/domains/agents/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 2601
+    },
+    "BackgroundTasksLibSQL": {
+      "types": "dist/storage/domains/background-tasks/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 3435
+    },
+    "BlobsLibSQL": {
+      "types": "dist/storage/domains/blobs/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 3737
+    },
+    "ChannelsLibSQL": {
+      "types": "dist/storage/domains/channels/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 3835
+    },
+    "DatasetsLibSQL": {
+      "types": "dist/storage/domains/datasets/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 4032
+    },
+    "DefaultStorage": {
+      "types": "dist/storage/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 17333
+    },
+    "LibSQLStore": {
+      "types": "dist/storage/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 17333
+    },
+    "ExperimentsLibSQL": {
+      "types": "dist/storage/domains/experiments/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 5294
+    },
+    "FavoritesLibSQL": {
+      "types": "dist/storage/domains/favorites/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6153
+    },
+    "HarnessLibSQL": {
+      "types": "dist/storage/domains/harness/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6481
+    },
+    "KnowledgeLibSQL": {
+      "types": "dist/storage/domains/knowledge/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 8142
+    },
+    "LIBSQL_PROMPT": {
+      "types": "dist/vector/prompt.d.ts",
+      "implementation": "dist/index.js",
+      "line": 17532
+    },
+    "LibSQLFactoryStorage": {
+      "types": "dist/storage/factory-storage.d.ts",
+      "implementation": "dist/index.js",
+      "line": 17185
+    },
+    "LibSQLVector": {
+      "types": "dist/vector/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 839
+    },
+    "MCPClientsLibSQL": {
+      "types": "dist/storage/domains/mcp-clients/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 8337
+    },
+    "MCPServersLibSQL": {
+      "types": "dist/storage/domains/mcp-servers/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 8760
+    },
+    "MemoryLibSQL": {
+      "types": "dist/storage/domains/memory/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 9316
+    },
+    "NotificationsLibSQL": {
+      "types": "dist/storage/domains/notifications/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 11701
+    },
+    "ObservabilityLibSQL": {
+      "types": "dist/storage/domains/observability/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 12008
+    },
+    "PromptBlocksLibSQL": {
+      "types": "dist/storage/domains/prompt-blocks/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 12524
+    },
+    "SchedulesLibSQL": {
+      "types": "dist/storage/domains/schedules/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 13000
+    },
+    "ScorerDefinitionsLibSQL": {
+      "types": "dist/storage/domains/scorer-definitions/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 13298
+    },
+    "ScoresLibSQL": {
+      "types": "dist/storage/domains/scores/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 13736
+    },
+    "SkillsLibSQL": {
+      "types": "dist/storage/domains/skills/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 14078
+    },
+    "ThreadStateLibSQL": {
+      "types": "dist/storage/domains/thread-state/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 14634
+    },
+    "ToolProviderConnectionsLibSQL": {
+      "types": "dist/storage/domains/tool-provider-connections/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 14777
+    },
+    "WorkflowDefinitionsLibSQL": {
+      "types": "dist/storage/domains/workflow-definitions/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 15012
+    },
+    "WorkflowsLibSQL": {
+      "types": "dist/storage/domains/workflows/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 15370
+    },
+    "WorkspacesLibSQL": {
+      "types": "dist/storage/domains/workspaces/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 16422
+    }
+  },
+  "modules": {}
+}