@mastra/mongodb 1.25.0-alpha.0 → 1.26.0-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.
- package/dist/_types/@internal_core/dist/knowledge-compat/index.d.ts +338 -0
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/docs-memory-semantic-recall.md +2 -0
- package/dist/docs/references/reference-rag-retrieval.md +5 -1
- package/dist/index.cjs +1837 -728
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +1838 -729
- package/dist/index.js.map +1 -1
- package/dist/storage/domains/knowledge/index.d.ts +40 -77
- package/dist/storage/domains/knowledge/index.d.ts.map +1 -1
- package/dist/storage/domains/knowledge/pages.d.ts +172 -0
- package/dist/storage/domains/knowledge/pages.d.ts.map +1 -0
- package/package.json +7 -7
|
@@ -1,86 +1,49 @@
|
|
|
1
1
|
import { KnowledgeStorage } from '@mastra/core/storage';
|
|
2
|
-
import type {
|
|
2
|
+
import type { KnowledgePageStore } from '@mastra/core/storage';
|
|
3
3
|
import type { MongoDBDomainConfig } from '../../types.js';
|
|
4
|
+
/** @experimental Knowledge APIs are experimental and may change without notice. */
|
|
4
5
|
export declare class KnowledgeMongoDB extends KnowledgeStorage {
|
|
5
6
|
#private;
|
|
6
|
-
static readonly MANAGED_COLLECTIONS:
|
|
7
|
+
static readonly MANAGED_COLLECTIONS: ("mastra_knowledge_access_state" | "mastra_knowledge_activity" | "mastra_knowledge_notes" | "mastra_knowledge_pages" | "mastra_knowledge_pins")[];
|
|
7
8
|
constructor(config: MongoDBDomainConfig);
|
|
9
|
+
getCapabilities(): {
|
|
10
|
+
readonly contractVersion: typeof import("@mastra/core/knowledge").KNOWLEDGE_STORAGE_CONTRACT_VERSION;
|
|
11
|
+
readonly schemaVersion: 4;
|
|
12
|
+
readonly supportsSchemaInspection: true;
|
|
13
|
+
readonly supportsExplicitReset: true;
|
|
14
|
+
};
|
|
8
15
|
init(): Promise<void>;
|
|
16
|
+
inspectSchema(): Promise<import("../../../_types/@internal_core/dist/knowledge-compat/index.js").KnowledgePagesSchemaInspection>;
|
|
17
|
+
dangerouslyReset(): Promise<void>;
|
|
9
18
|
dangerouslyClearAll(): Promise<void>;
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
}): Promise<KnowledgeRecord>;
|
|
40
|
-
restoreKnowledge(input: {
|
|
41
|
-
id: string;
|
|
42
|
-
}): Promise<KnowledgeRecord>;
|
|
43
|
-
rescopeKnowledge(input: {
|
|
44
|
-
id: string;
|
|
45
|
-
scope: KnowledgeScope;
|
|
46
|
-
}): Promise<KnowledgeRecord>;
|
|
47
|
-
search(input: SearchKnowledgeInput): Promise<SearchKnowledgeResult[]>;
|
|
48
|
-
/**
|
|
49
|
-
* @deprecated Curation cursors were removed. Observation-time curate is the only Knowledge writer and needs no
|
|
50
|
-
* cursor. Always throws.
|
|
51
|
-
*/
|
|
52
|
-
getCurationCursor(_input: {
|
|
53
|
-
sourceThreadId: string;
|
|
54
|
-
agent: string;
|
|
55
|
-
}): Promise<KnowledgeCurationCursor | null>;
|
|
56
|
-
/**
|
|
57
|
-
* @deprecated Curation cursors were removed. Observation-time curate is the only Knowledge writer and needs no
|
|
58
|
-
* cursor. Always throws.
|
|
59
|
-
*/
|
|
60
|
-
advanceCurationCursor(_input: {
|
|
61
|
-
sourceThreadId: string;
|
|
62
|
-
agent: string;
|
|
63
|
-
lastKnowledgeId: string;
|
|
64
|
-
}): Promise<KnowledgeCurationCursor>;
|
|
65
|
-
listActivity(input: {
|
|
66
|
-
scope: KnowledgeScope;
|
|
67
|
-
after?: string;
|
|
68
|
-
limit?: number;
|
|
69
|
-
}): Promise<KnowledgeActivityEvent[]>;
|
|
70
|
-
listSemanticOutbox(input?: {
|
|
71
|
-
status?: KnowledgeSemanticOutboxEntry['status'];
|
|
72
|
-
scope?: KnowledgeScope;
|
|
73
|
-
limit?: number;
|
|
74
|
-
}): Promise<KnowledgeSemanticOutboxEntry[]>;
|
|
75
|
-
claimSemanticOutbox(input: ClaimKnowledgeSemanticOutboxInput): Promise<KnowledgeSemanticOutboxEntry[]>;
|
|
76
|
-
completeSemanticOutbox(input: {
|
|
77
|
-
ids: string[];
|
|
78
|
-
workerId: string;
|
|
79
|
-
}): Promise<void>;
|
|
80
|
-
releaseSemanticOutbox(input: {
|
|
81
|
-
ids: string[];
|
|
82
|
-
workerId: string;
|
|
83
|
-
retryAt?: Date;
|
|
84
|
-
}): Promise<void>;
|
|
19
|
+
materializeScope(input: Parameters<KnowledgePageStore['materializeScope']>[0]): ReturnType<KnowledgePageStore['materializeScope']>;
|
|
20
|
+
getScopesByAddress(input: Parameters<KnowledgePageStore['getScopesByAddress']>[0]): ReturnType<KnowledgePageStore['getScopesByAddress']>;
|
|
21
|
+
listScopeDeclarations(): ReturnType<KnowledgePageStore['listScopeDeclarations']>;
|
|
22
|
+
renameScopeDeclaration(input: Parameters<KnowledgePageStore['renameScopeDeclaration']>[0]): ReturnType<KnowledgePageStore['renameScopeDeclaration']>;
|
|
23
|
+
listChildScopes(input: Parameters<KnowledgePageStore['listChildScopes']>[0]): ReturnType<KnowledgePageStore['listChildScopes']>;
|
|
24
|
+
getPages(input: Parameters<KnowledgePageStore['getPages']>[0]): ReturnType<KnowledgePageStore['getPages']>;
|
|
25
|
+
getPage(input: Parameters<KnowledgePageStore['getPage']>[0]): ReturnType<KnowledgePageStore['getPage']>;
|
|
26
|
+
getPageByPath(input: Parameters<KnowledgePageStore['getPageByPath']>[0]): ReturnType<KnowledgePageStore['getPageByPath']>;
|
|
27
|
+
findPagesByName(input: Parameters<KnowledgePageStore['findPagesByName']>[0]): ReturnType<KnowledgePageStore['findPagesByName']>;
|
|
28
|
+
listChildPages(input: Parameters<KnowledgePageStore['listChildPages']>[0]): ReturnType<KnowledgePageStore['listChildPages']>;
|
|
29
|
+
listPages(input: Parameters<KnowledgePageStore['listPages']>[0]): ReturnType<KnowledgePageStore['listPages']>;
|
|
30
|
+
createPage(input: Parameters<KnowledgePageStore['createPage']>[0]): ReturnType<KnowledgePageStore['createPage']>;
|
|
31
|
+
updatePage(input: Parameters<KnowledgePageStore['updatePage']>[0]): ReturnType<KnowledgePageStore['updatePage']>;
|
|
32
|
+
movePage(input: Parameters<KnowledgePageStore['movePage']>[0]): ReturnType<KnowledgePageStore['movePage']>;
|
|
33
|
+
mergePages(input: Parameters<KnowledgePageStore['mergePages']>[0]): ReturnType<KnowledgePageStore['mergePages']>;
|
|
34
|
+
deletePage(input: Parameters<KnowledgePageStore['deletePage']>[0]): ReturnType<KnowledgePageStore['deletePage']>;
|
|
35
|
+
getNote(input: Parameters<KnowledgePageStore['getNote']>[0]): ReturnType<KnowledgePageStore['getNote']>;
|
|
36
|
+
listNotes(input: Parameters<KnowledgePageStore['listNotes']>[0]): ReturnType<KnowledgePageStore['listNotes']>;
|
|
37
|
+
countNotes(input: Parameters<KnowledgePageStore['countNotes']>[0]): ReturnType<KnowledgePageStore['countNotes']>;
|
|
38
|
+
listNotesMentioning(input: Parameters<KnowledgePageStore['listNotesMentioning']>[0]): ReturnType<KnowledgePageStore['listNotesMentioning']>;
|
|
39
|
+
addNote(input: Parameters<KnowledgePageStore['addNote']>[0]): ReturnType<KnowledgePageStore['addNote']>;
|
|
40
|
+
restampNote(input: Parameters<KnowledgePageStore['restampNote']>[0]): ReturnType<KnowledgePageStore['restampNote']>;
|
|
41
|
+
removeNote(input: Parameters<KnowledgePageStore['removeNote']>[0]): ReturnType<KnowledgePageStore['removeNote']>;
|
|
42
|
+
restoreNote(input: Parameters<KnowledgePageStore['restoreNote']>[0]): ReturnType<KnowledgePageStore['restoreNote']>;
|
|
43
|
+
searchPages(input: Parameters<KnowledgePageStore['searchPages']>[0]): ReturnType<KnowledgePageStore['searchPages']>;
|
|
44
|
+
listPageActivity(input: Parameters<KnowledgePageStore['listPageActivity']>[0]): ReturnType<KnowledgePageStore['listPageActivity']>;
|
|
45
|
+
addPinAudience(input: Parameters<KnowledgePageStore['addPinAudience']>[0]): ReturnType<KnowledgePageStore['addPinAudience']>;
|
|
46
|
+
removePinAudience(input: Parameters<KnowledgePageStore['removePinAudience']>[0]): ReturnType<KnowledgePageStore['removePinAudience']>;
|
|
47
|
+
listPins(input: Parameters<KnowledgePageStore['listPins']>[0]): ReturnType<KnowledgePageStore['listPins']>;
|
|
85
48
|
}
|
|
86
49
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/knowledge/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/knowledge/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKvD,mFAAmF;AACnF,qBAAa,gBAAiB,SAAQ,gBAAgB;;IACpD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,oJAAoD;IAKvF,YAAY,MAAM,EAAE,mBAAmB,EAatC;IAEQ,eAAe;;;;;MAOvB;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEc,aAAa,sFAE3B;IAEc,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC;IAEQ,gBAAgB,CACvB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3D,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAEpD;IAEQ,kBAAkB,CACzB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC7D,UAAU,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CAEtD;IAEQ,qBAAqB,IAAI,UAAU,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAExF;IAEQ,sBAAsB,CAC7B,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,GACjE,UAAU,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAE1D;IAEQ,eAAe,CACtB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1D,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAEnD;IAEQ,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAElH;IAEQ,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAE/G;IAEQ,aAAa,CACpB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GACxD,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAEjD;IAEQ,eAAe,CACtB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1D,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAEnD;IAEQ,cAAc,CACrB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GACzD,UAAU,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAElD;IAEQ,SAAS,CAChB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAE7C;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAElH;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAE/G;IAEQ,SAAS,CAChB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAE7C;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,mBAAmB,CAC1B,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9D,UAAU,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAEvD;IAEQ,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAE/G;IAEQ,WAAW,CAClB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAE/C;IAEQ,UAAU,CACjB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAE9C;IAEQ,WAAW,CAClB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAE/C;IAEQ,WAAW,CAClB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAE/C;IAEQ,gBAAgB,CACvB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3D,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAEpD;IAEQ,cAAc,CACrB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GACzD,UAAU,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAElD;IAEQ,iBAAiB,CACxB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5D,UAAU,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAErD;IAEQ,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAElH;CACF"}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
import type { KnowledgePagesSchemaInspection } from '../../../_types/@internal_core/dist/knowledge-compat/index.js';
|
|
2
|
+
import type { AddKnowledgeNoteInput, CreateKnowledgePageInput, KnowledgeNote, KnowledgeNoteListOutput, KnowledgePage, KnowledgePageActivityEvent, KnowledgePageListOutput, KnowledgePageSearchHit, KnowledgePageStore, KnowledgeListedPin, KnowledgePin, KnowledgeProvenance, KnowledgeReadScope, KnowledgeScopeDeclarationCount, KnowledgeScopeDeclarationRename, MaterializeKnowledgeScopeInput, MaterializeKnowledgeScopeResult, MergeKnowledgePagesInput, MoveKnowledgePageInput, SearchKnowledgePagesInput, UpdateKnowledgePageInput } from '@mastra/core/storage';
|
|
3
|
+
import type { MongoDBConnector } from '../../connectors/MongoDBConnector.js';
|
|
4
|
+
export declare const MONGO_KNOWLEDGE_PAGES_COLLECTIONS: {
|
|
5
|
+
readonly pages: 'mastra_knowledge_pages';
|
|
6
|
+
readonly notes: 'mastra_knowledge_notes';
|
|
7
|
+
readonly pins: 'mastra_knowledge_pins';
|
|
8
|
+
readonly activity: 'mastra_knowledge_activity';
|
|
9
|
+
readonly state: 'mastra_knowledge_access_state';
|
|
10
|
+
};
|
|
11
|
+
export interface MongoKnowledgePagesBounds {
|
|
12
|
+
assertKnowledgePageDescriptionWithinBound(description: string | undefined): void;
|
|
13
|
+
assertKnowledgeNoteTextWithinBound(text: string): void;
|
|
14
|
+
}
|
|
15
|
+
/** Thrown when existing Knowledge collections can't be used as schema 4 without a reset. */
|
|
16
|
+
export declare class MongoKnowledgeResetRequiredError extends Error {
|
|
17
|
+
readonly inspection: Extract<KnowledgePagesSchemaInspection, {
|
|
18
|
+
status: 'incompatible-reset-required';
|
|
19
|
+
}>;
|
|
20
|
+
constructor(inspection: Extract<KnowledgePagesSchemaInspection, {
|
|
21
|
+
status: 'incompatible-reset-required';
|
|
22
|
+
}>);
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* MongoDB implementation of the schema-4 {@link KnowledgePageStore}.
|
|
26
|
+
*
|
|
27
|
+
* Notes embed their stamps and mentions and carry two denormalized copies of page scope
|
|
28
|
+
* (`pageScopeId`, `mentionScopeIds`); activity events carry `pageScopeId`. Moves and merges rewrite
|
|
29
|
+
* those copies in the same transaction as the page rows, so a read is one indexed filter against the
|
|
30
|
+
* set of readable scope ids resolved from the read scope (never a per-address query).
|
|
31
|
+
*/
|
|
32
|
+
export declare class MongoKnowledgePages implements KnowledgePageStore {
|
|
33
|
+
#private;
|
|
34
|
+
constructor(options: {
|
|
35
|
+
connector: MongoDBConnector;
|
|
36
|
+
bounds: () => Promise<MongoKnowledgePagesBounds>;
|
|
37
|
+
});
|
|
38
|
+
inspectSchema(): Promise<KnowledgePagesSchemaInspection>;
|
|
39
|
+
init(): Promise<void>;
|
|
40
|
+
/** Drops exactly the Knowledge collections (never Memory's) and recreates schema 4. */
|
|
41
|
+
reset(): Promise<void>;
|
|
42
|
+
materializeScope(input: MaterializeKnowledgeScopeInput): Promise<MaterializeKnowledgeScopeResult>;
|
|
43
|
+
getScopesByAddress(addresses: string[]): Promise<KnowledgePage[]>;
|
|
44
|
+
listScopeDeclarations(): Promise<KnowledgeScopeDeclarationCount[]>;
|
|
45
|
+
renameScopeDeclaration(input: {
|
|
46
|
+
from: string;
|
|
47
|
+
to: string;
|
|
48
|
+
check: (scopes: KnowledgeScopeDeclarationRename[]) => void;
|
|
49
|
+
}): Promise<number>;
|
|
50
|
+
listChildScopes(input: {
|
|
51
|
+
parentId: string | null;
|
|
52
|
+
cursor?: string;
|
|
53
|
+
limit?: number;
|
|
54
|
+
}): Promise<KnowledgePageListOutput>;
|
|
55
|
+
getPage(input: {
|
|
56
|
+
id: string;
|
|
57
|
+
read: KnowledgeReadScope;
|
|
58
|
+
}): Promise<KnowledgePage | null>;
|
|
59
|
+
getPageByPath(input: {
|
|
60
|
+
scopeId: string;
|
|
61
|
+
path: string[];
|
|
62
|
+
read: KnowledgeReadScope;
|
|
63
|
+
}): Promise<KnowledgePage | null>;
|
|
64
|
+
findPagesByName(input: {
|
|
65
|
+
name: string;
|
|
66
|
+
read: KnowledgeReadScope;
|
|
67
|
+
scopeId?: string;
|
|
68
|
+
limit?: number;
|
|
69
|
+
}): Promise<KnowledgePage[]>;
|
|
70
|
+
listChildPages(input: {
|
|
71
|
+
parentId: string;
|
|
72
|
+
read: KnowledgeReadScope;
|
|
73
|
+
cursor?: string;
|
|
74
|
+
limit?: number;
|
|
75
|
+
}): Promise<KnowledgePageListOutput>;
|
|
76
|
+
listPages(input: {
|
|
77
|
+
read: KnowledgeReadScope;
|
|
78
|
+
scopeId?: string;
|
|
79
|
+
namePrefix?: string;
|
|
80
|
+
cursor?: string;
|
|
81
|
+
limit?: number;
|
|
82
|
+
}): Promise<KnowledgePageListOutput>;
|
|
83
|
+
createPage(input: CreateKnowledgePageInput): Promise<KnowledgePage>;
|
|
84
|
+
updatePage(input: UpdateKnowledgePageInput): Promise<KnowledgePage>;
|
|
85
|
+
movePage(input: MoveKnowledgePageInput): Promise<KnowledgePage>;
|
|
86
|
+
mergePages(input: MergeKnowledgePagesInput): Promise<KnowledgePage>;
|
|
87
|
+
deletePage(input: {
|
|
88
|
+
id: string;
|
|
89
|
+
expectedVersion: number;
|
|
90
|
+
deletedBy: string;
|
|
91
|
+
}): Promise<KnowledgePage>;
|
|
92
|
+
getNote(input: {
|
|
93
|
+
id: string;
|
|
94
|
+
read: KnowledgeReadScope;
|
|
95
|
+
includeDeleted?: boolean;
|
|
96
|
+
}): Promise<KnowledgeNote | null>;
|
|
97
|
+
listNotes(input: {
|
|
98
|
+
pageId: string;
|
|
99
|
+
read: KnowledgeReadScope;
|
|
100
|
+
cursor?: string;
|
|
101
|
+
limit?: number;
|
|
102
|
+
includeDeleted?: boolean;
|
|
103
|
+
}): Promise<KnowledgeNoteListOutput>;
|
|
104
|
+
countNotes(input: {
|
|
105
|
+
pageIds: string[];
|
|
106
|
+
read: KnowledgeReadScope;
|
|
107
|
+
}): Promise<Record<string, number>>;
|
|
108
|
+
listNotesMentioning(input: {
|
|
109
|
+
pageId: string;
|
|
110
|
+
read: KnowledgeReadScope;
|
|
111
|
+
cursor?: string;
|
|
112
|
+
limit?: number;
|
|
113
|
+
}): Promise<KnowledgeNoteListOutput>;
|
|
114
|
+
addNote(input: AddKnowledgeNoteInput): Promise<KnowledgeNote>;
|
|
115
|
+
restampNote(input: {
|
|
116
|
+
id: string;
|
|
117
|
+
expectedVersion: number;
|
|
118
|
+
stampScopeIds: string[];
|
|
119
|
+
provenance: KnowledgeProvenance;
|
|
120
|
+
}): Promise<KnowledgeNote>;
|
|
121
|
+
removeNote(input: {
|
|
122
|
+
id: string;
|
|
123
|
+
deletedBy: string;
|
|
124
|
+
provenance: KnowledgeProvenance;
|
|
125
|
+
}): Promise<KnowledgeNote>;
|
|
126
|
+
restoreNote(input: {
|
|
127
|
+
id: string;
|
|
128
|
+
provenance: KnowledgeProvenance;
|
|
129
|
+
}): Promise<KnowledgeNote>;
|
|
130
|
+
searchPages(input: SearchKnowledgePagesInput): Promise<KnowledgePageSearchHit[]>;
|
|
131
|
+
listPageActivity(input: {
|
|
132
|
+
read: KnowledgeReadScope;
|
|
133
|
+
scopeId?: string;
|
|
134
|
+
pageId?: string;
|
|
135
|
+
cursor?: string;
|
|
136
|
+
limit?: number;
|
|
137
|
+
}): Promise<{
|
|
138
|
+
events: KnowledgePageActivityEvent[];
|
|
139
|
+
nextCursor?: string;
|
|
140
|
+
}>;
|
|
141
|
+
/** Deletes every document but keeps the collections, indexes and schema-version marker. */
|
|
142
|
+
clearAll(): Promise<void>;
|
|
143
|
+
addPinAudience(input: {
|
|
144
|
+
pageId: string;
|
|
145
|
+
audience: string[];
|
|
146
|
+
createdBy: string;
|
|
147
|
+
}): Promise<KnowledgePin>;
|
|
148
|
+
removePinAudience(input: {
|
|
149
|
+
pageId: string;
|
|
150
|
+
audience: string[];
|
|
151
|
+
removedBy: string;
|
|
152
|
+
}): Promise<KnowledgePin | null>;
|
|
153
|
+
getPages(input: {
|
|
154
|
+
ids: string[];
|
|
155
|
+
read: KnowledgeReadScope;
|
|
156
|
+
}): Promise<KnowledgePage[]>;
|
|
157
|
+
listPins(input: {
|
|
158
|
+
audience: string[] | 'all';
|
|
159
|
+
read: KnowledgeReadScope;
|
|
160
|
+
pageIds?: string[];
|
|
161
|
+
excludePageIds?: string[];
|
|
162
|
+
withBody?: boolean;
|
|
163
|
+
count?: boolean;
|
|
164
|
+
cursor?: string;
|
|
165
|
+
limit?: number;
|
|
166
|
+
}): Promise<{
|
|
167
|
+
pins: KnowledgeListedPin[];
|
|
168
|
+
nextCursor?: string;
|
|
169
|
+
total?: number;
|
|
170
|
+
}>;
|
|
171
|
+
}
|
|
172
|
+
//# sourceMappingURL=pages.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/knowledge/pages.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mongodb",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.26.0-alpha.0",
|
|
4
4
|
"description": "MongoDB provider for Mastra - includes vector store capabilities",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -32,12 +32,12 @@
|
|
|
32
32
|
"tsx": "^4.23.15",
|
|
33
33
|
"typescript": "^7.0.2",
|
|
34
34
|
"vitest": "4.1.12",
|
|
35
|
-
"@internal/
|
|
36
|
-
"@internal/
|
|
37
|
-
"@internal/
|
|
38
|
-
"@
|
|
39
|
-
"@
|
|
40
|
-
"@mastra/memory": "1.
|
|
35
|
+
"@internal/core": "0.1.4",
|
|
36
|
+
"@internal/lint": "0.0.147",
|
|
37
|
+
"@internal/storage-test-utils": "0.0.143",
|
|
38
|
+
"@internal/types-builder": "0.0.122",
|
|
39
|
+
"@mastra/core": "1.82.0-alpha.0",
|
|
40
|
+
"@mastra/memory": "1.41.0-alpha.0"
|
|
41
41
|
},
|
|
42
42
|
"peerDependencies": {
|
|
43
43
|
"@mastra/core": ">=1.76.0-0 <2.0.0-0"
|