@recallkit/core 0.1.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/README.md +69 -0
- package/dist/arkiv/client.d.ts +17 -0
- package/dist/arkiv/client.d.ts.map +1 -0
- package/dist/arkiv/client.js +29 -0
- package/dist/arkiv/client.js.map +1 -0
- package/dist/arkiv/entities.d.ts +11 -0
- package/dist/arkiv/entities.d.ts.map +1 -0
- package/dist/arkiv/entities.js +27 -0
- package/dist/arkiv/entities.js.map +1 -0
- package/dist/arkiv/index.d.ts +5 -0
- package/dist/arkiv/index.d.ts.map +1 -0
- package/dist/arkiv/index.js +5 -0
- package/dist/arkiv/index.js.map +1 -0
- package/dist/arkiv/queries.d.ts +7 -0
- package/dist/arkiv/queries.d.ts.map +1 -0
- package/dist/arkiv/queries.js +56 -0
- package/dist/arkiv/queries.js.map +1 -0
- package/dist/arkiv/writes.d.ts +19 -0
- package/dist/arkiv/writes.d.ts.map +1 -0
- package/dist/arkiv/writes.js +37 -0
- package/dist/arkiv/writes.js.map +1 -0
- package/dist/constants.d.ts +19 -0
- package/dist/constants.d.ts.map +1 -0
- package/dist/constants.js +19 -0
- package/dist/constants.js.map +1 -0
- package/dist/crypto/encryption.d.ts +4 -0
- package/dist/crypto/encryption.d.ts.map +1 -0
- package/dist/crypto/encryption.js +34 -0
- package/dist/crypto/encryption.js.map +1 -0
- package/dist/crypto/index.d.ts +3 -0
- package/dist/crypto/index.d.ts.map +1 -0
- package/dist/crypto/index.js +3 -0
- package/dist/crypto/index.js.map +1 -0
- package/dist/crypto/keys.d.ts +8 -0
- package/dist/crypto/keys.d.ts.map +1 -0
- package/dist/crypto/keys.js +54 -0
- package/dist/crypto/keys.js.map +1 -0
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/memory/compiler.d.ts +7 -0
- package/dist/memory/compiler.d.ts.map +1 -0
- package/dist/memory/compiler.js +148 -0
- package/dist/memory/compiler.js.map +1 -0
- package/dist/memory/conflict.d.ts +10 -0
- package/dist/memory/conflict.d.ts.map +1 -0
- package/dist/memory/conflict.js +38 -0
- package/dist/memory/conflict.js.map +1 -0
- package/dist/memory/consolidation.d.ts +3 -0
- package/dist/memory/consolidation.d.ts.map +1 -0
- package/dist/memory/consolidation.js +38 -0
- package/dist/memory/consolidation.js.map +1 -0
- package/dist/memory/index.d.ts +7 -0
- package/dist/memory/index.d.ts.map +1 -0
- package/dist/memory/index.js +7 -0
- package/dist/memory/index.js.map +1 -0
- package/dist/memory/schemas.d.ts +75 -0
- package/dist/memory/schemas.d.ts.map +1 -0
- package/dist/memory/schemas.js +5 -0
- package/dist/memory/schemas.js.map +1 -0
- package/dist/memory/scope.d.ts +24 -0
- package/dist/memory/scope.d.ts.map +1 -0
- package/dist/memory/scope.js +96 -0
- package/dist/memory/scope.js.map +1 -0
- package/dist/memory/scoring.d.ts +6 -0
- package/dist/memory/scoring.d.ts.map +1 -0
- package/dist/memory/scoring.js +39 -0
- package/dist/memory/scoring.js.map +1 -0
- package/dist/retrieval/contextPack.d.ts +21 -0
- package/dist/retrieval/contextPack.d.ts.map +1 -0
- package/dist/retrieval/contextPack.js +40 -0
- package/dist/retrieval/contextPack.js.map +1 -0
- package/dist/retrieval/embeddings.d.ts +6 -0
- package/dist/retrieval/embeddings.d.ts.map +1 -0
- package/dist/retrieval/embeddings.js +23 -0
- package/dist/retrieval/embeddings.js.map +1 -0
- package/dist/retrieval/hybridRanker.d.ts +7 -0
- package/dist/retrieval/hybridRanker.d.ts.map +1 -0
- package/dist/retrieval/hybridRanker.js +50 -0
- package/dist/retrieval/hybridRanker.js.map +1 -0
- package/dist/retrieval/index.d.ts +6 -0
- package/dist/retrieval/index.d.ts.map +1 -0
- package/dist/retrieval/index.js +6 -0
- package/dist/retrieval/index.js.map +1 -0
- package/dist/retrieval/indexSearch.d.ts +19 -0
- package/dist/retrieval/indexSearch.d.ts.map +1 -0
- package/dist/retrieval/indexSearch.js +44 -0
- package/dist/retrieval/indexSearch.js.map +1 -0
- package/dist/retrieval/queryUnderstanding.d.ts +9 -0
- package/dist/retrieval/queryUnderstanding.d.ts.map +1 -0
- package/dist/retrieval/queryUnderstanding.js +27 -0
- package/dist/retrieval/queryUnderstanding.js.map +1 -0
- package/dist/storage/cacheStore.d.ts +3 -0
- package/dist/storage/cacheStore.d.ts.map +1 -0
- package/dist/storage/cacheStore.js +10 -0
- package/dist/storage/cacheStore.js.map +1 -0
- package/dist/storage/configStore.d.ts +10 -0
- package/dist/storage/configStore.d.ts.map +1 -0
- package/dist/storage/configStore.js +40 -0
- package/dist/storage/configStore.js.map +1 -0
- package/dist/storage/index.d.ts +6 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +6 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/jsonFile.d.ts +5 -0
- package/dist/storage/jsonFile.d.ts.map +1 -0
- package/dist/storage/jsonFile.js +23 -0
- package/dist/storage/jsonFile.js.map +1 -0
- package/dist/storage/paths.d.ts +7 -0
- package/dist/storage/paths.d.ts.map +1 -0
- package/dist/storage/paths.js +21 -0
- package/dist/storage/paths.js.map +1 -0
- package/dist/storage/pendingMemoryStore.d.ts +9 -0
- package/dist/storage/pendingMemoryStore.d.ts.map +1 -0
- package/dist/storage/pendingMemoryStore.js +74 -0
- package/dist/storage/pendingMemoryStore.js.map +1 -0
- package/dist/tests/memory/scope.test.d.ts +2 -0
- package/dist/tests/memory/scope.test.d.ts.map +1 -0
- package/dist/tests/memory/scope.test.js +46 -0
- package/dist/tests/memory/scope.test.js.map +1 -0
- package/dist/tests/retrieval/indexSearch.test.d.ts +2 -0
- package/dist/tests/retrieval/indexSearch.test.d.ts.map +1 -0
- package/dist/tests/retrieval/indexSearch.test.js +76 -0
- package/dist/tests/retrieval/indexSearch.test.js.map +1 -0
- package/dist/types.d.ts +93 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +29 -0
- package/dist/types.js.map +1 -0
- package/package.json +77 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import assert from "node:assert/strict";
|
|
2
|
+
import test from "node:test";
|
|
3
|
+
import { isMemoryEntryInScope } from "../../memory/scope.js";
|
|
4
|
+
function entry(input) {
|
|
5
|
+
return {
|
|
6
|
+
memoryId: input.memoryId ?? "mem",
|
|
7
|
+
packEntityKey: "pack",
|
|
8
|
+
kind: "fact",
|
|
9
|
+
scope: { level: "global" },
|
|
10
|
+
summary: "summary",
|
|
11
|
+
keywords: [],
|
|
12
|
+
topics: [],
|
|
13
|
+
semanticSummary: "summary",
|
|
14
|
+
importance: 0.5,
|
|
15
|
+
confidence: 0.9,
|
|
16
|
+
status: "active",
|
|
17
|
+
createdAt: "2026-01-01T00:00:00.000Z",
|
|
18
|
+
...input,
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
test("global_only includes only global memories", () => {
|
|
22
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "global" } }), { scopeMode: "global_only" }), true);
|
|
23
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "project", projectId: "recallkit" } }), { scopeMode: "global_only" }), false);
|
|
24
|
+
});
|
|
25
|
+
test("project_with_global includes matching project and global memories", () => {
|
|
26
|
+
const params = { projectId: "recallkit", scopeMode: "project_with_global" };
|
|
27
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "global" } }), params), true);
|
|
28
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "project", projectId: "recallkit" } }), params), true);
|
|
29
|
+
});
|
|
30
|
+
test("project_with_global excludes other projects", () => {
|
|
31
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "project", projectId: "other-project" } }), {
|
|
32
|
+
projectId: "recallkit",
|
|
33
|
+
scopeMode: "project_with_global",
|
|
34
|
+
}), false);
|
|
35
|
+
});
|
|
36
|
+
test("project_only includes only matching project memories", () => {
|
|
37
|
+
const params = { projectId: "recallkit", scopeMode: "project_only" };
|
|
38
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "project", projectId: "recallkit" } }), params), true);
|
|
39
|
+
assert.equal(isMemoryEntryInScope(entry({ scope: { level: "global" } }), params), false);
|
|
40
|
+
});
|
|
41
|
+
test("inactive entries are excluded", () => {
|
|
42
|
+
for (const status of ["superseded", "archived", "deleted"]) {
|
|
43
|
+
assert.equal(isMemoryEntryInScope(entry({ status, scope: { level: "global" } }), { scopeMode: "global_only" }), false);
|
|
44
|
+
}
|
|
45
|
+
});
|
|
46
|
+
//# sourceMappingURL=scope.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scope.test.js","sourceRoot":"","sources":["../../../src/tests/memory/scope.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"indexSearch.test.d.ts","sourceRoot":"","sources":["../../../src/tests/retrieval/indexSearch.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import assert from "node:assert/strict";
|
|
2
|
+
import test from "node:test";
|
|
3
|
+
import { buildRankedContextPack } from "../../retrieval/contextPack.js";
|
|
4
|
+
import { MemoryIndexSearcher } from "../../retrieval/indexSearch.js";
|
|
5
|
+
const now = new Date("2026-05-24T10:00:00.000Z").toISOString();
|
|
6
|
+
function entry(input) {
|
|
7
|
+
return {
|
|
8
|
+
memoryId: input.memoryId,
|
|
9
|
+
packEntityKey: input.packEntityKey ?? "pack_1",
|
|
10
|
+
kind: input.kind ?? "decision",
|
|
11
|
+
scope: input.scope ?? { level: "global" },
|
|
12
|
+
summary: input.summary,
|
|
13
|
+
keywords: input.keywords ?? [],
|
|
14
|
+
topics: input.topics ?? [],
|
|
15
|
+
semanticSummary: input.semanticSummary ?? input.summary,
|
|
16
|
+
...(input.embedding ? { embedding: input.embedding } : {}),
|
|
17
|
+
importance: input.importance ?? 0.5,
|
|
18
|
+
confidence: input.confidence ?? 0.8,
|
|
19
|
+
status: input.status ?? "active",
|
|
20
|
+
createdAt: input.createdAt ?? now,
|
|
21
|
+
...(input.updatedAt ? { updatedAt: input.updatedAt } : {}),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
function memory(id, summary, importance = 0.5) {
|
|
25
|
+
return {
|
|
26
|
+
id,
|
|
27
|
+
kind: "decision",
|
|
28
|
+
subject: "RecallKit",
|
|
29
|
+
predicate: "remembers",
|
|
30
|
+
object: summary,
|
|
31
|
+
naturalText: summary,
|
|
32
|
+
summary,
|
|
33
|
+
scope: { level: "global" },
|
|
34
|
+
evidence: {
|
|
35
|
+
source: "agent_inference",
|
|
36
|
+
confidence: 0.9,
|
|
37
|
+
reason: "test fixture",
|
|
38
|
+
createdByAgent: "test",
|
|
39
|
+
},
|
|
40
|
+
retrieval: {
|
|
41
|
+
keywords: summary.toLowerCase().split(/\s+/),
|
|
42
|
+
topics: [],
|
|
43
|
+
semanticSummary: summary,
|
|
44
|
+
importance,
|
|
45
|
+
freshness: 1,
|
|
46
|
+
},
|
|
47
|
+
lifecycle: {
|
|
48
|
+
status: "active",
|
|
49
|
+
createdAt: now,
|
|
50
|
+
},
|
|
51
|
+
links: {
|
|
52
|
+
relatedMemoryIds: [],
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
test("ranked context preserves search match order", () => {
|
|
57
|
+
const matches = [
|
|
58
|
+
{ ...entry({ memoryId: "second", summary: "second ranked memory" }), score: 0.9 },
|
|
59
|
+
{ ...entry({ memoryId: "first", summary: "first ranked memory" }), score: 0.8 },
|
|
60
|
+
];
|
|
61
|
+
const context = buildRankedContextPack(matches, [
|
|
62
|
+
memory("first", "first ranked memory"),
|
|
63
|
+
memory("second", "second ranked memory"),
|
|
64
|
+
]);
|
|
65
|
+
assert.deepEqual(context.memories.map((item) => item.id), ["second", "first"]);
|
|
66
|
+
assert.equal(context.answerHint, "second ranked memory");
|
|
67
|
+
});
|
|
68
|
+
test("searcher can boost entries with local query embeddings", () => {
|
|
69
|
+
const searcher = new MemoryIndexSearcher([
|
|
70
|
+
entry({ memoryId: "semantic", summary: "unrelated words", embedding: [1, 0], importance: 0.4 }),
|
|
71
|
+
entry({ memoryId: "other", summary: "unrelated words", embedding: [0, 1], importance: 0.4 }),
|
|
72
|
+
]);
|
|
73
|
+
const matches = searcher.search("different phrasing", { queryEmbedding: [1, 0], limit: 2 });
|
|
74
|
+
assert.equal(matches[0]?.memoryId, "semantic");
|
|
75
|
+
});
|
|
76
|
+
//# sourceMappingURL=indexSearch.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"indexSearch.test.js","sourceRoot":"","sources":["../../../src/tests/retrieval/indexSearch.test.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { MemoryKind, MemoryRecord, MemoryScope, MemoryStatus } from "./memory/schemas.js";
|
|
2
|
+
export type Attribute = {
|
|
3
|
+
key: string;
|
|
4
|
+
value: string | number;
|
|
5
|
+
};
|
|
6
|
+
export type EncryptedPayload = {
|
|
7
|
+
version: 1;
|
|
8
|
+
encrypted: true;
|
|
9
|
+
algorithm: "AES-GCM";
|
|
10
|
+
kdf: "PBKDF2";
|
|
11
|
+
salt: string;
|
|
12
|
+
iv: string;
|
|
13
|
+
ciphertext: string;
|
|
14
|
+
};
|
|
15
|
+
export type MemoryManifestPayload = {
|
|
16
|
+
schemaVersion: 1;
|
|
17
|
+
ownerWallet: string;
|
|
18
|
+
latestCommitId: string;
|
|
19
|
+
latestIndexCheckpointEntityKey: string;
|
|
20
|
+
activePackEntityKeys: string[];
|
|
21
|
+
createdAt: string;
|
|
22
|
+
};
|
|
23
|
+
export type MemoryPackPayload = {
|
|
24
|
+
schemaVersion: 1;
|
|
25
|
+
packId: string;
|
|
26
|
+
ownerWallet: string;
|
|
27
|
+
commitId: string;
|
|
28
|
+
memories: MemoryRecord[];
|
|
29
|
+
createdAt: string;
|
|
30
|
+
};
|
|
31
|
+
export type CachedMemoryPackPayload = {
|
|
32
|
+
schemaVersion: 1;
|
|
33
|
+
packId: string;
|
|
34
|
+
ownerWallet: string;
|
|
35
|
+
commitId: string;
|
|
36
|
+
memories: MemoryRecord[];
|
|
37
|
+
createdAt: string;
|
|
38
|
+
entityKey: string;
|
|
39
|
+
};
|
|
40
|
+
export type MemoryIndexEntry = {
|
|
41
|
+
memoryId: string;
|
|
42
|
+
packEntityKey: string;
|
|
43
|
+
kind: MemoryKind;
|
|
44
|
+
scope: MemoryScope;
|
|
45
|
+
summary: string;
|
|
46
|
+
keywords: string[];
|
|
47
|
+
topics: string[];
|
|
48
|
+
semanticSummary: string;
|
|
49
|
+
embedding?: number[];
|
|
50
|
+
importance: number;
|
|
51
|
+
confidence: number;
|
|
52
|
+
status: MemoryStatus;
|
|
53
|
+
createdAt: string;
|
|
54
|
+
updatedAt?: string;
|
|
55
|
+
};
|
|
56
|
+
export type MemoryIndexCheckpointPayload = {
|
|
57
|
+
schemaVersion: 1;
|
|
58
|
+
checkpointId: string;
|
|
59
|
+
ownerWallet: string;
|
|
60
|
+
entries: MemoryIndexEntry[];
|
|
61
|
+
createdAt: string;
|
|
62
|
+
};
|
|
63
|
+
export type MemoryCommitPayload = {
|
|
64
|
+
schemaVersion: 1;
|
|
65
|
+
commitId: string;
|
|
66
|
+
ownerWallet: string;
|
|
67
|
+
message: string;
|
|
68
|
+
addedMemoryIds: string[];
|
|
69
|
+
supersededMemoryIds: string[];
|
|
70
|
+
packEntityKeys: string[];
|
|
71
|
+
indexCheckpointEntityKey: string;
|
|
72
|
+
previousCommitId?: string;
|
|
73
|
+
createdFrom: "skill" | "agent" | "import";
|
|
74
|
+
approvedByUser: true;
|
|
75
|
+
createdAt: string;
|
|
76
|
+
};
|
|
77
|
+
export type WalletStatus = {
|
|
78
|
+
connected: boolean;
|
|
79
|
+
ownerWallet?: string;
|
|
80
|
+
network?: string;
|
|
81
|
+
approvalAppUrl: string;
|
|
82
|
+
};
|
|
83
|
+
export type ArkivWalletClient = unknown;
|
|
84
|
+
export type ArkivPublicClient = unknown;
|
|
85
|
+
export type ArkivEntity = {
|
|
86
|
+
key: string;
|
|
87
|
+
payload?: unknown;
|
|
88
|
+
attributes?: Attribute[];
|
|
89
|
+
createdAt?: string | number;
|
|
90
|
+
};
|
|
91
|
+
export declare function isMemoryIndexCheckpointPayload(value: unknown): value is MemoryIndexCheckpointPayload;
|
|
92
|
+
export declare function isCachedMemoryPackPayload(value: unknown): value is CachedMemoryPackPayload;
|
|
93
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
const MAX_PAYLOAD_ID_LENGTH = 128;
|
|
2
|
+
function isRecord(value) {
|
|
3
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
4
|
+
}
|
|
5
|
+
export function isMemoryIndexCheckpointPayload(value) {
|
|
6
|
+
if (!isRecord(value))
|
|
7
|
+
return false;
|
|
8
|
+
return (value.schemaVersion === 1 &&
|
|
9
|
+
typeof value.checkpointId === "string" &&
|
|
10
|
+
value.checkpointId.length <= MAX_PAYLOAD_ID_LENGTH &&
|
|
11
|
+
typeof value.ownerWallet === "string" &&
|
|
12
|
+
Array.isArray(value.entries) &&
|
|
13
|
+
typeof value.createdAt === "string");
|
|
14
|
+
}
|
|
15
|
+
export function isCachedMemoryPackPayload(value) {
|
|
16
|
+
if (!isRecord(value))
|
|
17
|
+
return false;
|
|
18
|
+
return (value.schemaVersion === 1 &&
|
|
19
|
+
typeof value.packId === "string" &&
|
|
20
|
+
value.packId.length <= MAX_PAYLOAD_ID_LENGTH &&
|
|
21
|
+
typeof value.ownerWallet === "string" &&
|
|
22
|
+
typeof value.commitId === "string" &&
|
|
23
|
+
value.commitId.length <= MAX_PAYLOAD_ID_LENGTH &&
|
|
24
|
+
Array.isArray(value.memories) &&
|
|
25
|
+
typeof value.createdAt === "string" &&
|
|
26
|
+
typeof value.entityKey === "string" &&
|
|
27
|
+
value.entityKey.length <= MAX_PAYLOAD_ID_LENGTH);
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAsGD,MAAM,UAAU,8BAA8B,CAC5C,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CACL,KAAK,CAAC,aAAa,KAAK,CAAC;QACzB,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;QACtC,KAAK,CAAC,YAAY,CAAC,MAAM,IAAI,qBAAqB;QAClD,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CACL,KAAK,CAAC,aAAa,KAAK,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,qBAAqB;QAC5C,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,qBAAqB;QAC9C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC7B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,qBAAqB,CAChD,CAAC;AACJ,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@recallkit/core",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"sideEffects": false,
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js"
|
|
12
|
+
},
|
|
13
|
+
"./constants": {
|
|
14
|
+
"types": "./dist/constants.d.ts",
|
|
15
|
+
"import": "./dist/constants.js"
|
|
16
|
+
},
|
|
17
|
+
"./crypto": {
|
|
18
|
+
"types": "./dist/crypto/index.d.ts",
|
|
19
|
+
"import": "./dist/crypto/index.js"
|
|
20
|
+
},
|
|
21
|
+
"./keys": {
|
|
22
|
+
"types": "./dist/crypto/keys.d.ts",
|
|
23
|
+
"import": "./dist/crypto/keys.js"
|
|
24
|
+
},
|
|
25
|
+
"./memory": {
|
|
26
|
+
"types": "./dist/memory/index.d.ts",
|
|
27
|
+
"import": "./dist/memory/index.js"
|
|
28
|
+
},
|
|
29
|
+
"./schemas": {
|
|
30
|
+
"types": "./dist/memory/schemas.d.ts",
|
|
31
|
+
"import": "./dist/memory/schemas.js"
|
|
32
|
+
},
|
|
33
|
+
"./retrieval": {
|
|
34
|
+
"types": "./dist/retrieval/index.d.ts",
|
|
35
|
+
"import": "./dist/retrieval/index.js"
|
|
36
|
+
},
|
|
37
|
+
"./arkiv": {
|
|
38
|
+
"types": "./dist/arkiv/index.d.ts",
|
|
39
|
+
"import": "./dist/arkiv/index.js"
|
|
40
|
+
},
|
|
41
|
+
"./arkiv-client": {
|
|
42
|
+
"types": "./dist/arkiv/client.d.ts",
|
|
43
|
+
"import": "./dist/arkiv/client.js"
|
|
44
|
+
},
|
|
45
|
+
"./arkiv-entities": {
|
|
46
|
+
"types": "./dist/arkiv/entities.d.ts",
|
|
47
|
+
"import": "./dist/arkiv/entities.js"
|
|
48
|
+
},
|
|
49
|
+
"./storage": {
|
|
50
|
+
"types": "./dist/storage/index.d.ts",
|
|
51
|
+
"import": "./dist/storage/index.js"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"scripts": {
|
|
55
|
+
"build": "tsc -p tsconfig.json",
|
|
56
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
57
|
+
"test": "pnpm build && node --test dist/tests/memory/scope.test.js dist/tests/retrieval/indexSearch.test.js"
|
|
58
|
+
},
|
|
59
|
+
"dependencies": {
|
|
60
|
+
"minisearch": "^7.2.0",
|
|
61
|
+
"nanoid": "^5.1.11"
|
|
62
|
+
},
|
|
63
|
+
"optionalDependencies": {
|
|
64
|
+
"@arkiv-network/sdk": "^0.6.8"
|
|
65
|
+
},
|
|
66
|
+
"devDependencies": {
|
|
67
|
+
"@types/node": "^25.9.1",
|
|
68
|
+
"typescript": "^5.9.3"
|
|
69
|
+
},
|
|
70
|
+
"publishConfig": {
|
|
71
|
+
"access": "public"
|
|
72
|
+
},
|
|
73
|
+
"files": [
|
|
74
|
+
"dist",
|
|
75
|
+
"README.md"
|
|
76
|
+
]
|
|
77
|
+
}
|