@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.
Files changed (130) hide show
  1. package/README.md +69 -0
  2. package/dist/arkiv/client.d.ts +17 -0
  3. package/dist/arkiv/client.d.ts.map +1 -0
  4. package/dist/arkiv/client.js +29 -0
  5. package/dist/arkiv/client.js.map +1 -0
  6. package/dist/arkiv/entities.d.ts +11 -0
  7. package/dist/arkiv/entities.d.ts.map +1 -0
  8. package/dist/arkiv/entities.js +27 -0
  9. package/dist/arkiv/entities.js.map +1 -0
  10. package/dist/arkiv/index.d.ts +5 -0
  11. package/dist/arkiv/index.d.ts.map +1 -0
  12. package/dist/arkiv/index.js +5 -0
  13. package/dist/arkiv/index.js.map +1 -0
  14. package/dist/arkiv/queries.d.ts +7 -0
  15. package/dist/arkiv/queries.d.ts.map +1 -0
  16. package/dist/arkiv/queries.js +56 -0
  17. package/dist/arkiv/queries.js.map +1 -0
  18. package/dist/arkiv/writes.d.ts +19 -0
  19. package/dist/arkiv/writes.d.ts.map +1 -0
  20. package/dist/arkiv/writes.js +37 -0
  21. package/dist/arkiv/writes.js.map +1 -0
  22. package/dist/constants.d.ts +19 -0
  23. package/dist/constants.d.ts.map +1 -0
  24. package/dist/constants.js +19 -0
  25. package/dist/constants.js.map +1 -0
  26. package/dist/crypto/encryption.d.ts +4 -0
  27. package/dist/crypto/encryption.d.ts.map +1 -0
  28. package/dist/crypto/encryption.js +34 -0
  29. package/dist/crypto/encryption.js.map +1 -0
  30. package/dist/crypto/index.d.ts +3 -0
  31. package/dist/crypto/index.d.ts.map +1 -0
  32. package/dist/crypto/index.js +3 -0
  33. package/dist/crypto/index.js.map +1 -0
  34. package/dist/crypto/keys.d.ts +8 -0
  35. package/dist/crypto/keys.d.ts.map +1 -0
  36. package/dist/crypto/keys.js +54 -0
  37. package/dist/crypto/keys.js.map +1 -0
  38. package/dist/index.d.ts +8 -0
  39. package/dist/index.d.ts.map +1 -0
  40. package/dist/index.js +8 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/memory/compiler.d.ts +7 -0
  43. package/dist/memory/compiler.d.ts.map +1 -0
  44. package/dist/memory/compiler.js +148 -0
  45. package/dist/memory/compiler.js.map +1 -0
  46. package/dist/memory/conflict.d.ts +10 -0
  47. package/dist/memory/conflict.d.ts.map +1 -0
  48. package/dist/memory/conflict.js +38 -0
  49. package/dist/memory/conflict.js.map +1 -0
  50. package/dist/memory/consolidation.d.ts +3 -0
  51. package/dist/memory/consolidation.d.ts.map +1 -0
  52. package/dist/memory/consolidation.js +38 -0
  53. package/dist/memory/consolidation.js.map +1 -0
  54. package/dist/memory/index.d.ts +7 -0
  55. package/dist/memory/index.d.ts.map +1 -0
  56. package/dist/memory/index.js +7 -0
  57. package/dist/memory/index.js.map +1 -0
  58. package/dist/memory/schemas.d.ts +75 -0
  59. package/dist/memory/schemas.d.ts.map +1 -0
  60. package/dist/memory/schemas.js +5 -0
  61. package/dist/memory/schemas.js.map +1 -0
  62. package/dist/memory/scope.d.ts +24 -0
  63. package/dist/memory/scope.d.ts.map +1 -0
  64. package/dist/memory/scope.js +96 -0
  65. package/dist/memory/scope.js.map +1 -0
  66. package/dist/memory/scoring.d.ts +6 -0
  67. package/dist/memory/scoring.d.ts.map +1 -0
  68. package/dist/memory/scoring.js +39 -0
  69. package/dist/memory/scoring.js.map +1 -0
  70. package/dist/retrieval/contextPack.d.ts +21 -0
  71. package/dist/retrieval/contextPack.d.ts.map +1 -0
  72. package/dist/retrieval/contextPack.js +40 -0
  73. package/dist/retrieval/contextPack.js.map +1 -0
  74. package/dist/retrieval/embeddings.d.ts +6 -0
  75. package/dist/retrieval/embeddings.d.ts.map +1 -0
  76. package/dist/retrieval/embeddings.js +23 -0
  77. package/dist/retrieval/embeddings.js.map +1 -0
  78. package/dist/retrieval/hybridRanker.d.ts +7 -0
  79. package/dist/retrieval/hybridRanker.d.ts.map +1 -0
  80. package/dist/retrieval/hybridRanker.js +50 -0
  81. package/dist/retrieval/hybridRanker.js.map +1 -0
  82. package/dist/retrieval/index.d.ts +6 -0
  83. package/dist/retrieval/index.d.ts.map +1 -0
  84. package/dist/retrieval/index.js +6 -0
  85. package/dist/retrieval/index.js.map +1 -0
  86. package/dist/retrieval/indexSearch.d.ts +19 -0
  87. package/dist/retrieval/indexSearch.d.ts.map +1 -0
  88. package/dist/retrieval/indexSearch.js +44 -0
  89. package/dist/retrieval/indexSearch.js.map +1 -0
  90. package/dist/retrieval/queryUnderstanding.d.ts +9 -0
  91. package/dist/retrieval/queryUnderstanding.d.ts.map +1 -0
  92. package/dist/retrieval/queryUnderstanding.js +27 -0
  93. package/dist/retrieval/queryUnderstanding.js.map +1 -0
  94. package/dist/storage/cacheStore.d.ts +3 -0
  95. package/dist/storage/cacheStore.d.ts.map +1 -0
  96. package/dist/storage/cacheStore.js +10 -0
  97. package/dist/storage/cacheStore.js.map +1 -0
  98. package/dist/storage/configStore.d.ts +10 -0
  99. package/dist/storage/configStore.d.ts.map +1 -0
  100. package/dist/storage/configStore.js +40 -0
  101. package/dist/storage/configStore.js.map +1 -0
  102. package/dist/storage/index.d.ts +6 -0
  103. package/dist/storage/index.d.ts.map +1 -0
  104. package/dist/storage/index.js +6 -0
  105. package/dist/storage/index.js.map +1 -0
  106. package/dist/storage/jsonFile.d.ts +5 -0
  107. package/dist/storage/jsonFile.d.ts.map +1 -0
  108. package/dist/storage/jsonFile.js +23 -0
  109. package/dist/storage/jsonFile.js.map +1 -0
  110. package/dist/storage/paths.d.ts +7 -0
  111. package/dist/storage/paths.d.ts.map +1 -0
  112. package/dist/storage/paths.js +21 -0
  113. package/dist/storage/paths.js.map +1 -0
  114. package/dist/storage/pendingMemoryStore.d.ts +9 -0
  115. package/dist/storage/pendingMemoryStore.d.ts.map +1 -0
  116. package/dist/storage/pendingMemoryStore.js +74 -0
  117. package/dist/storage/pendingMemoryStore.js.map +1 -0
  118. package/dist/tests/memory/scope.test.d.ts +2 -0
  119. package/dist/tests/memory/scope.test.d.ts.map +1 -0
  120. package/dist/tests/memory/scope.test.js +46 -0
  121. package/dist/tests/memory/scope.test.js.map +1 -0
  122. package/dist/tests/retrieval/indexSearch.test.d.ts +2 -0
  123. package/dist/tests/retrieval/indexSearch.test.d.ts.map +1 -0
  124. package/dist/tests/retrieval/indexSearch.test.js +76 -0
  125. package/dist/tests/retrieval/indexSearch.test.js.map +1 -0
  126. package/dist/types.d.ts +93 -0
  127. package/dist/types.d.ts.map +1 -0
  128. package/dist/types.js +29 -0
  129. package/dist/types.js.map +1 -0
  130. 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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=indexSearch.test.d.ts.map
@@ -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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"}
@@ -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
+ }