@mastra/libsql 0.0.0-key-fix-20260227010020 → 0.0.0-knowledge-w1-20261006001735

package/LICENSE.md

@@ -1,3 +1,20 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named `ee/` within this
+  repository, including but not limited to:
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
 # Apache License 2.0
 
 Copyright (c) 2025 Kepler Software, Inc.

package/README.md

@@ -16,27 +16,30 @@ npm install @mastra/libsql
 import { LibSQLVector } from '@mastra/libsql';
 
 const vectorStore = new LibSQLVector({
-  url: 'file:./my-db.db'
+  url: 'file:./my-db.db',
 });
 
 // Create a new table with vector support
 await vectorStore.createIndex({
   indexName: 'my_vectors',
-  dimension: 1536,
+  dimension: 3,
   metric: 'cosine',
 });
 
 // Add vectors
 const ids = await vectorStore.upsert({
   indexName: 'my_vectors',
-  vectors: [[0.1, 0.2, ...], [0.3, 0.4, ...]],
+  vectors: [
+    [0.1, 0.2, 0.3],
+    [0.3, 0.4, 0.5],
+  ],
   metadata: [{ text: 'doc1' }, { text: 'doc2' }],
 });
 
 // Query vectors
 const results = await vectorStore.query({
   indexName: 'my_vectors',
-  queryVector: [0.1, 0.2, ...],
+  queryVector: [0.1, 0.2, 0.3],
   topK: 10, // topK
   filter: { text: 'doc1' }, // filter
   includeVector: false, // includeVector
@@ -44,111 +47,14 @@ const results = await vectorStore.query({
 });
 ```
 
-### Storage
-
-```typescript
-import { LibSQLStore } from '@mastra/libsql';
-
-const store = new LibSQLStore({
-  id: 'libsql-storage',
-  url: 'file:./my-db.db',
-});
-
-// Create a thread
-await store.saveThread({
-  thread: {
-    id: 'thread-123',
-    resourceId: 'resource-456',
-    title: 'My Thread',
-    metadata: { key: 'value' },
-    createdAt: new Date(),
-  },
-});
-
-// Add messages to thread
-await store.saveMessages({
-  messages: [
-    {
-      id: 'msg-789',
-      threadId: 'thread-123',
-      role: 'user',
-      content: { content: 'Hello' },
-      resourceId: 'resource-456',
-      createdAt: new Date(),
-    },
-  ],
-});
-
-// Query threads and messages
-const savedThread = await store.getThreadById({ threadId: 'thread-123' });
-const messages = await store.listMessages({ threadId: 'thread-123' });
-```
-
-## Configuration
-
-The LibSQLStore store can be initialized with:
-
-- Configuration object with url and auth. Auth is only necessary when using a provider like [Turso](https://turso.tech/)
-
-## Features
-
-### Vector Store Features
-
-- Vector similarity search with cosine, euclidean, and dot product metrics
-- Advanced metadata filtering with MongoDB-like query syntax
-- Minimum score threshold for queries
-- Automatic UUID generation for vectors
-- Table management (create, list, describe, delete, truncate)
-
-### Storage Features
-
-- Thread and message storage with JSON support
-- Atomic transactions for data consistency
-- Efficient batch operations
-- Rich metadata support
-- Timestamp tracking
-- Cascading deletes
-
-## Supported Filter Operators
-
-The following filter operators are supported for metadata queries:
-
-- Comparison: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`
-- Logical: `$and`, `$or`
-- Array: `$in`, `$nin`
-- Text: `$regex`, `$like`
-
-Example filter:
-
-```typescript
-{
-  $and: [{ age: { $gt: 25 } }, { tags: { $in: ['tag1', 'tag2'] } }];
-}
-```
-
-## Vector Store Methods
+## Documentation
 
-- `createIndex({indexName, dimension, metric?, indexConfig?, defineIndex?})`: Create a new table with vector support
-- `upsert({indexName, vectors, metadata?, ids?})`: Add or update vectors
-- `query({indexName, queryVector, topK?, filter?, includeVector?, minScore?})`: Search for similar vectors
-- `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
-- `deleteVector({ indexName, id })`: Delete a single vector by ID
-- `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
-- `defineIndex({indexName, metric?, indexConfig?})`: Define an index
-- `listIndexes()`: List all vector-enabled tables
-- `describeIndex(indexName)`: Get table statistics
-- `deleteIndex(indexName)`: Delete a table
-- `truncateIndex(indexName)`: Remove all data from a table
+- [@mastra/libsql documentation](https://mastra.ai/reference/vectors/libsql)
 
-## Storage Methods
+## Changelog
 
-- `saveThread({ thread })`: Create or update a thread
-- `getThreadById({ threadId })`: Get a thread by ID
-- `deleteThread({ threadId })`: Delete a thread and its messages
-- `saveMessages({ messages })`: Save multiple messages in a transaction
-- `listMessages({ threadId, perPage?, page? })`: Get messages for a thread with pagination
-- `deleteMessages(messageIds)`: Delete specific messages
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/libsql/CHANGELOG.md) for version history and release notes.
 
-## Related Links
+## Support
 
-- [LibSQL Documentation](https://docs.turso.tech/sdk/introductionh)
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/_types/@internal_core/dist/knowledge-compat/index.d.ts

@@ -0,0 +1,533 @@
+//#region src/knowledge-compat/index.d.ts
+declare const KNOWLEDGE_V2_CORE_FEATURE = "knowledge-v2";
+declare const KNOWLEDGE_V2_MINIMUM_CORE_VERSION = "1.65.0-0";
+declare const KNOWLEDGE_STORAGE_CONTRACT_VERSION: 2;
+declare const KNOWLEDGE_STORAGE_SCHEMA_VERSION: 2;
+/** Hard cap on scope nodes returned by one `listScopeNodes` read. */
+declare const MAX_KNOWLEDGE_SCOPE_NODES = 1000;
+/** A reconciled structural scope node with its containing scope nodes. */
+interface KnowledgeScopeNodeSummary {
+  /** UUID of the `isScope` node. */
+  id: string;
+  /** Canonical address the scope node was reconciled from (e.g. `features:memory`). */
+  address: string;
+  name: string;
+  kind?: string;
+  description?: string;
+  /** UUIDs of the scope nodes that contain this scope (membership edges). */
+  parentIds: string[];
+}
+declare const TABLE_KNOWLEDGE_NODE_SCOPES = "mastra_knowledge_node_scopes";
+declare const TABLE_KNOWLEDGE_RECORD_SCOPES = "mastra_knowledge_record_scopes";
+declare const TABLE_KNOWLEDGE_SCOPE_GRANTS = "mastra_knowledge_scope_grants";
+declare const TABLE_KNOWLEDGE_ACCESS_STATE = "mastra_knowledge_access_state";
+declare const TABLE_KNOWLEDGE_SCOPE_ADDRESSES = "mastra_knowledge_scope_addresses";
+declare const TABLE_KNOWLEDGE_NODE_ADDRESSES = "mastra_knowledge_node_addresses";
+declare const TABLE_KNOWLEDGE_IMPORT_STATE = "mastra_knowledge_import_state";
+declare const TABLE_KNOWLEDGE_IMPORT_RUNS = "mastra_knowledge_import_runs";
+declare const TABLE_KNOWLEDGE_PROPOSALS = "mastra_knowledge_proposals";
+declare const KNOWLEDGE_TABLE_NAMES: readonly ["mastra_knowledge_nodes", "mastra_knowledge_records", "mastra_knowledge_mentions", "mastra_knowledge_cursors", "mastra_knowledge_activity", "mastra_knowledge_semantic_outbox", "mastra_knowledge_node_scopes", "mastra_knowledge_record_scopes", "mastra_knowledge_scope_grants", "mastra_knowledge_access_state", "mastra_knowledge_scope_addresses", "mastra_knowledge_node_addresses", "mastra_knowledge_import_state", "mastra_knowledge_import_runs", "mastra_knowledge_proposals"];
+declare const KNOWLEDGE_V2_NODES_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly name: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly kind: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly isScope: {
+    readonly type: 'boolean';
+    readonly nullable: false;
+  };
+  readonly metadata: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly version: {
+    readonly type: 'integer';
+    readonly nullable: false;
+  };
+  readonly createdAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly updatedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly deletedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly deletedBy: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly type: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly canonicalName: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly content: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly description: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly scope: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly scopeKey: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly mergedInto: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly nodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly text: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly metadata: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly source: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly version: {
+    readonly type: 'integer';
+    readonly nullable: false;
+  };
+  readonly createdAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly updatedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly deletedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly deletedBy: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly node: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly scope: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly scopeKey: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly sourceThreadId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly capturedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly when: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly maxScope: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_V2_MENTIONS_SCHEMA: {
+  readonly recordId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_records";
+      readonly column: 'id';
+    };
+  };
+  readonly targetNodeId: {
+    readonly type: 'text';
+    readonly nullable: true;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly sourceType: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly sourceId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_NODE_SCOPES_SCHEMA: {
+  readonly nodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly scopeNodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly addedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+};
+declare const KNOWLEDGE_RECORD_SCOPES_SCHEMA: {
+  readonly recordId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_records";
+      readonly column: 'id';
+    };
+  };
+  readonly scopeNodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly addedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+};
+declare const KNOWLEDGE_SCOPE_GRANTS_SCHEMA: {
+  readonly scopeNodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly scopeRefId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly role: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly canSuggest: {
+    readonly type: 'boolean';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_ACCESS_STATE_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly epoch: {
+    readonly type: 'integer';
+    readonly nullable: false;
+  };
+  readonly schemaVersion: {
+    readonly type: 'integer';
+    readonly nullable: false;
+  };
+};
+declare const KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA: {
+  readonly address: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly scopeNodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+};
+declare const KNOWLEDGE_NODE_ADDRESSES_SCHEMA: {
+  readonly source: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly address: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly nodeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+};
+declare const KNOWLEDGE_IMPORT_STATE_SCHEMA: {
+  readonly importerId: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly binding: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly key: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly value: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+};
+declare const KNOWLEDGE_IMPORT_RUNS_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly importerId: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly binding: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly importKind: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly triggerKind: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly status: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly error: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly transcriptThreadId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly traceId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly queuedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly startedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly completedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly action: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly targetType: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly targetId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly contextScopeId: {
+    readonly type: 'text';
+    readonly nullable: true;
+    readonly references: {
+      readonly table: "mastra_knowledge_nodes";
+      readonly column: 'id';
+    };
+  };
+  readonly importRunId: {
+    readonly type: 'text';
+    readonly nullable: true;
+    readonly references: {
+      readonly table: "mastra_knowledge_import_runs";
+      readonly column: 'id';
+    };
+  };
+  readonly details: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly createdAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+  readonly recordType: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly recordId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly scope: {
+    readonly type: 'jsonb';
+    readonly nullable: true;
+  };
+  readonly scopeKey: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly sourceThreadId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+};
+declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
+  readonly id: {
+    readonly type: 'text';
+    readonly nullable: false;
+    readonly primaryKey: true;
+  };
+  readonly targetType: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly targetId: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly action: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly changes: {
+    readonly type: 'jsonb';
+    readonly nullable: false;
+  };
+  readonly reason: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly proposerContextScopeId: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly expectedVersion: {
+    readonly type: 'integer';
+    readonly nullable: false;
+  };
+  readonly status: {
+    readonly type: 'text';
+    readonly nullable: false;
+  };
+  readonly reviewerContextScopeId: {
+    readonly type: 'text';
+    readonly nullable: true;
+  };
+  readonly reviewedAt: {
+    readonly type: 'timestamp';
+    readonly nullable: true;
+  };
+  readonly createdAt: {
+    readonly type: 'timestamp';
+    readonly nullable: false;
+  };
+};
+type KnowledgeSchemaInspection = {
+  status: 'compatible';
+  schemaVersion: typeof KNOWLEDGE_STORAGE_SCHEMA_VERSION;
+} | {
+  status: 'uninitialized';
+  schemaVersion: null;
+} | {
+  status: 'incompatible-reset-required';
+  schemaVersion: number | null;
+  reason: string;
+} | {
+  status: 'unavailable';
+  schemaVersion: null;
+  reason: string;
+};
+interface KnowledgeSchemaSnapshot {
+  available: boolean;
+  tableNames: readonly string[];
+  schemaVersion?: number;
+  reason?: string;
+}
+interface KnowledgeV2Core {
+  assertKnowledgeDescriptionWithinBound(description: string | undefined): void;
+  assertKnowledgeSchemaCompatible(inspection: KnowledgeSchemaInspection): void;
+  inspectKnowledgeSchema(snapshot: KnowledgeSchemaSnapshot): KnowledgeSchemaInspection;
+}
+declare function assertKnowledgeV2CoreSupport(features: ReadonlySet<string>): void;
+declare function createKnowledgeV2CoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgeV2Core>;
+//#endregion
+export { KNOWLEDGE_ACCESS_STATE_SCHEMA, KNOWLEDGE_IMPORT_RUNS_SCHEMA, KNOWLEDGE_IMPORT_STATE_SCHEMA, KNOWLEDGE_NODE_ADDRESSES_SCHEMA, KNOWLEDGE_NODE_SCOPES_SCHEMA, KNOWLEDGE_PROPOSALS_SCHEMA, KNOWLEDGE_RECORD_SCOPES_SCHEMA, KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA, KNOWLEDGE_SCOPE_GRANTS_SCHEMA, KNOWLEDGE_STORAGE_CONTRACT_VERSION, KNOWLEDGE_STORAGE_SCHEMA_VERSION, KNOWLEDGE_TABLE_NAMES, KNOWLEDGE_V2_ACTIVITY_SCHEMA, KNOWLEDGE_V2_CORE_FEATURE, KNOWLEDGE_V2_MENTIONS_SCHEMA, KNOWLEDGE_V2_MINIMUM_CORE_VERSION, KNOWLEDGE_V2_NODES_SCHEMA, KNOWLEDGE_V2_RECORDS_SCHEMA, KnowledgeSchemaInspection, KnowledgeSchemaSnapshot, KnowledgeScopeNodeSummary, MAX_KNOWLEDGE_SCOPE_NODES, TABLE_KNOWLEDGE_ACCESS_STATE, TABLE_KNOWLEDGE_IMPORT_RUNS, TABLE_KNOWLEDGE_IMPORT_STATE, TABLE_KNOWLEDGE_NODE_ADDRESSES, TABLE_KNOWLEDGE_NODE_SCOPES, TABLE_KNOWLEDGE_PROPOSALS, TABLE_KNOWLEDGE_RECORD_SCOPES, TABLE_KNOWLEDGE_SCOPE_ADDRESSES, TABLE_KNOWLEDGE_SCOPE_GRANTS, assertKnowledgeV2CoreSupport, createKnowledgeV2CoreLoader };
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/@internal_core/package.json

@@ -0,0 +1 @@
+{"type":"module"}