@functional-systems/memdrive 0.1.1-dev.2 → 0.1.1-dev.4

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 (189) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +20 -279
  3. package/dist/commonjs/chunking.d.ts +1 -2
  4. package/dist/commonjs/chunking.d.ts.map +1 -1
  5. package/dist/commonjs/chunking.js +2 -5
  6. package/dist/commonjs/chunking.js.map +1 -1
  7. package/dist/commonjs/config.d.ts +17 -0
  8. package/dist/commonjs/config.d.ts.map +1 -0
  9. package/dist/commonjs/config.js +116 -0
  10. package/dist/commonjs/config.js.map +1 -0
  11. package/dist/commonjs/errors.d.ts +10 -6
  12. package/dist/commonjs/errors.d.ts.map +1 -1
  13. package/dist/commonjs/errors.js +25 -5
  14. package/dist/commonjs/errors.js.map +1 -1
  15. package/dist/commonjs/index.d.ts +15 -5
  16. package/dist/commonjs/index.d.ts.map +1 -1
  17. package/dist/commonjs/index.js +332 -280
  18. package/dist/commonjs/index.js.map +1 -1
  19. package/dist/commonjs/records.d.ts +44 -0
  20. package/dist/commonjs/records.d.ts.map +1 -0
  21. package/dist/commonjs/records.js +88 -0
  22. package/dist/commonjs/records.js.map +1 -0
  23. package/dist/commonjs/search.d.ts +8 -0
  24. package/dist/commonjs/search.d.ts.map +1 -0
  25. package/dist/commonjs/search.js +56 -0
  26. package/dist/commonjs/search.js.map +1 -0
  27. package/dist/commonjs/types.d.ts +84 -252
  28. package/dist/commonjs/types.d.ts.map +1 -1
  29. package/dist/esm/chunking.d.ts +1 -2
  30. package/dist/esm/chunking.d.ts.map +1 -1
  31. package/dist/esm/chunking.js +2 -4
  32. package/dist/esm/chunking.js.map +1 -1
  33. package/dist/esm/config.d.ts +17 -0
  34. package/dist/esm/config.d.ts.map +1 -0
  35. package/dist/esm/config.js +107 -0
  36. package/dist/esm/config.js.map +1 -0
  37. package/dist/esm/errors.d.ts +10 -6
  38. package/dist/esm/errors.d.ts.map +1 -1
  39. package/dist/esm/errors.js +22 -4
  40. package/dist/esm/errors.js.map +1 -1
  41. package/dist/esm/index.d.ts +15 -5
  42. package/dist/esm/index.d.ts.map +1 -1
  43. package/dist/esm/index.js +332 -278
  44. package/dist/esm/index.js.map +1 -1
  45. package/dist/esm/records.d.ts +44 -0
  46. package/dist/esm/records.d.ts.map +1 -0
  47. package/dist/esm/records.js +77 -0
  48. package/dist/esm/records.js.map +1 -0
  49. package/dist/esm/search.d.ts +8 -0
  50. package/dist/esm/search.d.ts.map +1 -0
  51. package/dist/esm/search.js +52 -0
  52. package/dist/esm/search.js.map +1 -0
  53. package/dist/esm/types.d.ts +84 -252
  54. package/dist/esm/types.d.ts.map +1 -1
  55. package/package.json +7 -42
  56. package/src/chunking.ts +2 -3
  57. package/src/config.ts +121 -0
  58. package/src/errors.ts +20 -6
  59. package/src/index.ts +352 -260
  60. package/src/records.ts +83 -0
  61. package/src/search.ts +57 -0
  62. package/src/types.ts +74 -253
  63. package/dist/commonjs/filter.d.ts +0 -30
  64. package/dist/commonjs/filter.d.ts.map +0 -1
  65. package/dist/commonjs/filter.js +0 -224
  66. package/dist/commonjs/filter.js.map +0 -1
  67. package/dist/commonjs/recall-input.d.ts +0 -8
  68. package/dist/commonjs/recall-input.d.ts.map +0 -1
  69. package/dist/commonjs/recall-input.js +0 -45
  70. package/dist/commonjs/recall-input.js.map +0 -1
  71. package/dist/commonjs/retriever/index.d.ts +0 -7
  72. package/dist/commonjs/retriever/index.d.ts.map +0 -1
  73. package/dist/commonjs/retriever/index.js +0 -167
  74. package/dist/commonjs/retriever/index.js.map +0 -1
  75. package/dist/commonjs/retriever/scope.d.ts +0 -5
  76. package/dist/commonjs/retriever/scope.d.ts.map +0 -1
  77. package/dist/commonjs/retriever/scope.js +0 -69
  78. package/dist/commonjs/retriever/scope.js.map +0 -1
  79. package/dist/commonjs/retriever/types.d.ts +0 -89
  80. package/dist/commonjs/retriever/types.d.ts.map +0 -1
  81. package/dist/commonjs/retriever/types.js +0 -3
  82. package/dist/commonjs/retriever/types.js.map +0 -1
  83. package/dist/commonjs/storage.d.ts +0 -274
  84. package/dist/commonjs/storage.d.ts.map +0 -1
  85. package/dist/commonjs/storage.js +0 -861
  86. package/dist/commonjs/storage.js.map +0 -1
  87. package/dist/commonjs/tools/definitions.d.ts +0 -5
  88. package/dist/commonjs/tools/definitions.d.ts.map +0 -1
  89. package/dist/commonjs/tools/definitions.js +0 -147
  90. package/dist/commonjs/tools/definitions.js.map +0 -1
  91. package/dist/commonjs/tools/evidence-ids.d.ts +0 -7
  92. package/dist/commonjs/tools/evidence-ids.d.ts.map +0 -1
  93. package/dist/commonjs/tools/evidence-ids.js +0 -71
  94. package/dist/commonjs/tools/evidence-ids.js.map +0 -1
  95. package/dist/commonjs/tools/factory.d.ts +0 -7
  96. package/dist/commonjs/tools/factory.d.ts.map +0 -1
  97. package/dist/commonjs/tools/factory.js +0 -169
  98. package/dist/commonjs/tools/factory.js.map +0 -1
  99. package/dist/commonjs/tools/index.d.ts +0 -6
  100. package/dist/commonjs/tools/index.d.ts.map +0 -1
  101. package/dist/commonjs/tools/index.js +0 -25
  102. package/dist/commonjs/tools/index.js.map +0 -1
  103. package/dist/commonjs/tools/internal-types.d.ts +0 -18
  104. package/dist/commonjs/tools/internal-types.d.ts.map +0 -1
  105. package/dist/commonjs/tools/internal-types.js +0 -3
  106. package/dist/commonjs/tools/internal-types.js.map +0 -1
  107. package/dist/commonjs/tools/short-ids.d.ts +0 -8
  108. package/dist/commonjs/tools/short-ids.d.ts.map +0 -1
  109. package/dist/commonjs/tools/short-ids.js +0 -81
  110. package/dist/commonjs/tools/short-ids.js.map +0 -1
  111. package/dist/commonjs/tools/types.d.ts +0 -53
  112. package/dist/commonjs/tools/types.d.ts.map +0 -1
  113. package/dist/commonjs/tools/types.js +0 -3
  114. package/dist/commonjs/tools/types.js.map +0 -1
  115. package/dist/commonjs/values.d.ts +0 -17
  116. package/dist/commonjs/values.d.ts.map +0 -1
  117. package/dist/commonjs/values.js +0 -90
  118. package/dist/commonjs/values.js.map +0 -1
  119. package/dist/esm/filter.d.ts +0 -30
  120. package/dist/esm/filter.d.ts.map +0 -1
  121. package/dist/esm/filter.js +0 -209
  122. package/dist/esm/filter.js.map +0 -1
  123. package/dist/esm/recall-input.d.ts +0 -8
  124. package/dist/esm/recall-input.d.ts.map +0 -1
  125. package/dist/esm/recall-input.js +0 -40
  126. package/dist/esm/recall-input.js.map +0 -1
  127. package/dist/esm/retriever/index.d.ts +0 -7
  128. package/dist/esm/retriever/index.d.ts.map +0 -1
  129. package/dist/esm/retriever/index.js +0 -163
  130. package/dist/esm/retriever/index.js.map +0 -1
  131. package/dist/esm/retriever/scope.d.ts +0 -5
  132. package/dist/esm/retriever/scope.d.ts.map +0 -1
  133. package/dist/esm/retriever/scope.js +0 -66
  134. package/dist/esm/retriever/scope.js.map +0 -1
  135. package/dist/esm/retriever/types.d.ts +0 -89
  136. package/dist/esm/retriever/types.d.ts.map +0 -1
  137. package/dist/esm/retriever/types.js +0 -2
  138. package/dist/esm/retriever/types.js.map +0 -1
  139. package/dist/esm/storage.d.ts +0 -274
  140. package/dist/esm/storage.d.ts.map +0 -1
  141. package/dist/esm/storage.js +0 -845
  142. package/dist/esm/storage.js.map +0 -1
  143. package/dist/esm/tools/definitions.d.ts +0 -5
  144. package/dist/esm/tools/definitions.d.ts.map +0 -1
  145. package/dist/esm/tools/definitions.js +0 -144
  146. package/dist/esm/tools/definitions.js.map +0 -1
  147. package/dist/esm/tools/evidence-ids.d.ts +0 -7
  148. package/dist/esm/tools/evidence-ids.d.ts.map +0 -1
  149. package/dist/esm/tools/evidence-ids.js +0 -68
  150. package/dist/esm/tools/evidence-ids.js.map +0 -1
  151. package/dist/esm/tools/factory.d.ts +0 -7
  152. package/dist/esm/tools/factory.d.ts.map +0 -1
  153. package/dist/esm/tools/factory.js +0 -166
  154. package/dist/esm/tools/factory.js.map +0 -1
  155. package/dist/esm/tools/index.d.ts +0 -6
  156. package/dist/esm/tools/index.d.ts.map +0 -1
  157. package/dist/esm/tools/index.js +0 -22
  158. package/dist/esm/tools/index.js.map +0 -1
  159. package/dist/esm/tools/internal-types.d.ts +0 -18
  160. package/dist/esm/tools/internal-types.d.ts.map +0 -1
  161. package/dist/esm/tools/internal-types.js +0 -2
  162. package/dist/esm/tools/internal-types.js.map +0 -1
  163. package/dist/esm/tools/short-ids.d.ts +0 -8
  164. package/dist/esm/tools/short-ids.d.ts.map +0 -1
  165. package/dist/esm/tools/short-ids.js +0 -78
  166. package/dist/esm/tools/short-ids.js.map +0 -1
  167. package/dist/esm/tools/types.d.ts +0 -53
  168. package/dist/esm/tools/types.d.ts.map +0 -1
  169. package/dist/esm/tools/types.js +0 -2
  170. package/dist/esm/tools/types.js.map +0 -1
  171. package/dist/esm/values.d.ts +0 -17
  172. package/dist/esm/values.d.ts.map +0 -1
  173. package/dist/esm/values.js +0 -87
  174. package/dist/esm/values.js.map +0 -1
  175. package/docs/tools.md +0 -264
  176. package/src/filter.ts +0 -189
  177. package/src/recall-input.ts +0 -46
  178. package/src/retriever/index.ts +0 -142
  179. package/src/retriever/scope.ts +0 -56
  180. package/src/retriever/types.ts +0 -68
  181. package/src/storage.ts +0 -765
  182. package/src/tools/definitions.ts +0 -175
  183. package/src/tools/evidence-ids.ts +0 -57
  184. package/src/tools/factory.ts +0 -153
  185. package/src/tools/index.ts +0 -25
  186. package/src/tools/internal-types.ts +0 -12
  187. package/src/tools/short-ids.ts +0 -58
  188. package/src/tools/types.ts +0 -48
  189. package/src/values.ts +0 -103
@@ -1,89 +0,0 @@
1
- import type { MemDrive, RecallRequest, Match, RequestOptions, TextRecallRequest } from '../types.js';
2
- import type { ToolDefinition, ToolResult } from '../tools/types.js';
3
- export interface ModelToolCall {
4
- id: string;
5
- name: string;
6
- arguments: unknown;
7
- }
8
- export interface ModelToolReply {
9
- id: string;
10
- name: string;
11
- result: ToolResult;
12
- }
13
- export interface ModelTurn {
14
- status: 'completed' | 'incomplete';
15
- calls?: ModelToolCall[];
16
- evidenceIds?: string[];
17
- usage: {
18
- inputTokens: number;
19
- outputTokens: number;
20
- };
21
- }
22
- export interface RetrievalModel {
23
- /** Local only: create isolated provider conversation state for this recall. */
24
- createSession(input: {
25
- request: TextRecallRequest;
26
- instructions: string;
27
- tools: ToolDefinition[];
28
- }): {
29
- /** Local only: append replies and prepare the next request without network dispatch. */
30
- prepare(replies: ModelToolReply[]): {
31
- /** Conservative estimate of the complete provider request, including schema/history overhead. */
32
- inputTokens: number;
33
- respond(options: {
34
- signal: AbortSignal;
35
- maxOutputTokens: number;
36
- }): Promise<ModelTurn>;
37
- };
38
- };
39
- }
40
- export interface AgentLimits {
41
- rounds: number;
42
- toolCalls: number;
43
- /** Public SDK calls; each recall batch item counts separately. Not native HTTP requests. */
44
- dataCalls: number;
45
- contextTokens: number;
46
- modelTokens: number;
47
- maxOutputTokens: number;
48
- toolResultTokens: number;
49
- timeoutMs: number;
50
- }
51
- export interface RetrieverUsage {
52
- elapsedMs: number;
53
- /** Null when any invoked primitive does not expose native request accounting. */
54
- databaseRequests: number | null;
55
- knownRecallDatabaseRequests: number;
56
- dataCalls: number;
57
- toolCalls: number;
58
- modelCalls: number;
59
- inputTokens: number;
60
- outputTokens: number;
61
- unknownUsageCalls: number;
62
- }
63
- export interface RetrievalResult {
64
- /** Only an explicit successful selection; never an automatic fallback candidate set. */
65
- matches: Match[];
66
- completion: {
67
- status: 'completed' | 'budget_exhausted' | 'aborted' | 'failed';
68
- reason?: string;
69
- };
70
- usage: RetrieverUsage;
71
- }
72
- export interface CreateRetrieverOptions {
73
- drive: MemDrive;
74
- strategy?: 'single_pass' | 'agentic';
75
- agent?: {
76
- model: RetrievalModel;
77
- /** Generic retrieval guidance by default; host-owned application guidance is optional. */
78
- instructions?: string;
79
- /** Token count for a complete serialized tool result; no text is silently truncated. */
80
- countTokens(text: string): number;
81
- limits?: Partial<AgentLimits>;
82
- };
83
- /** Scoped SDK orchestration events; underlying drive/native diagnostics have their own scope. */
84
- record?: (event: Record<string, unknown>) => void | Promise<void>;
85
- }
86
- export interface Retriever {
87
- recall(request: RecallRequest, options?: RequestOptions): Promise<RetrievalResult>;
88
- }
89
- //# sourceMappingURL=types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/retriever/types.ts"],"names":[],"mappings":"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"}
@@ -1,3 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- //# sourceMappingURL=types.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/retriever/types.ts"],"names":[],"mappings":""}
@@ -1,274 +0,0 @@
1
- import type { LambdaDBClient } from '@functional-systems/lambdadb';
2
- import type { MetadataSchema, Metadata, EmbeddingConfig, TextSearch, Filter, RequestOptions, DriveDescriptor, Mem } from './types.js';
3
- type NativeHandle = ReturnType<LambdaDBClient['collection']>;
4
- type NativeQuery = Parameters<NativeHandle['query']>[0];
5
- type NativeClient = Pick<LambdaDBClient, 'collection' | 'createCollection' | 'listCollections'>;
6
- type Connection = {
7
- client: NativeClient;
8
- name: string;
9
- };
10
- type CreateBackendOptions = Connection & {
11
- metadataSchema: unknown;
12
- textSearch?: unknown;
13
- embedding?: unknown;
14
- labels?: unknown;
15
- description?: unknown;
16
- };
17
- type Attributes = {
18
- timestamp?: string | undefined;
19
- metadata?: Metadata | undefined;
20
- };
21
- type TextMemInput = Attributes & {
22
- id?: string;
23
- content: string;
24
- };
25
- type TextMem = TextMemInput & {
26
- id: string;
27
- };
28
- type VectorMemInput = Attributes & {
29
- id?: string;
30
- embedding: number[];
31
- };
32
- type VectorMem = VectorMemInput & {
33
- id: string;
34
- };
35
- type OriginalMem = Attributes & {
36
- id: string;
37
- };
38
- export type Evidence = Attributes & {
39
- id: string;
40
- kind: 'mem' | 'chunk';
41
- memId: string;
42
- content: string;
43
- start: number;
44
- end: number;
45
- };
46
- export type VectorEvidence = Attributes & {
47
- id: string;
48
- kind: 'mem';
49
- memId: string;
50
- };
51
- type Executor = <T>(operation: () => Promise<T>) => Promise<T>;
52
- type QueryBody = Pick<NativeQuery, 'query' | 'size' | 'candidateSize' | 'rerank' | 'facets'>;
53
- type ReadRequest = {
54
- ids: string[];
55
- };
56
- type PageRequest = {
57
- limit?: number | undefined;
58
- cursor?: string | undefined;
59
- };
60
- type RememberRequest = {
61
- mems: unknown[];
62
- };
63
- type ForgetRequest = {
64
- ids: string[];
65
- filter?: never;
66
- } | {
67
- filter: Filter;
68
- ids?: never;
69
- };
70
- type ConfigureRequest = {
71
- metadataSchema?: MetadataSchema | undefined;
72
- description?: string | undefined;
73
- };
74
- type CatalogRequest = PageRequest & {
75
- client: NativeClient;
76
- labels?: Record<string, string> | undefined;
77
- };
78
- export declare function validateMem(mem: unknown, schema: MetadataSchema, options: {
79
- requireId: true;
80
- }): TextMem;
81
- export declare function validateMem(mem: unknown, schema: MetadataSchema, options?: {
82
- requireId?: boolean;
83
- }): TextMemInput;
84
- export declare function validateVector(vector: unknown, embedding: EmbeddingConfig): number[];
85
- export declare function validateVectorMem(mem: unknown, schema: MetadataSchema, embedding: EmbeddingConfig, options: {
86
- requireId: true;
87
- }): VectorMem;
88
- export declare function validateVectorMem(mem: unknown, schema: MetadataSchema, embedding: EmbeddingConfig, options?: {
89
- requireId?: boolean;
90
- }): VectorMemInput;
91
- export declare const sourceDocumentId: (id: string) => Promise<string>;
92
- type PublicEvidence<T> = T extends Evidence | VectorEvidence ? Omit<T, 'id'> : never;
93
- export declare function publicMatch<T extends Evidence | VectorEvidence>(evidence: T): PublicEvidence<T>;
94
- export declare function sourceMatch(mem: TextMem): Promise<Evidence>;
95
- export declare function validateChunk(doc: unknown, schema: MetadataSchema): Promise<Evidence>;
96
- export declare function validateSource(doc: unknown, schema: MetadataSchema): Promise<TextMem>;
97
- export declare function vectorSource(doc: unknown, schema: MetadataSchema): Promise<OriginalMem>;
98
- export declare function vectorMatch(doc: unknown, schema: MetadataSchema): Promise<VectorEvidence>;
99
- declare function load(handle: NativeHandle, name: string, options?: RequestOptions): Promise<{
100
- result: import("@functional-systems/lambdadb").GetCollectionResponseWithDates;
101
- schema: MetadataSchema;
102
- embedding: EmbeddingConfig;
103
- textSearch: TextSearch | undefined;
104
- }>;
105
- declare function backend(handle: NativeHandle, name: string, initial: Awaited<ReturnType<typeof load>>): {
106
- readonly metadataSchema: MetadataSchema;
107
- readonly textSearch: TextSearch | undefined;
108
- readonly embedding: Readonly<EmbeddingConfig>;
109
- readonly generation: number;
110
- assertActive: () => void;
111
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
112
- describeDescriptor(options?: RequestOptions): Promise<DriveDescriptor>;
113
- at(branch: string): {
114
- readonly metadataSchema: MetadataSchema;
115
- readonly textSearch: TextSearch | undefined;
116
- readonly embedding: Readonly<EmbeddingConfig>;
117
- readonly generation: number;
118
- assertActive: () => void;
119
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
120
- describeDescriptor: (options?: RequestOptions) => Promise<DriveDescriptor>;
121
- query(body: QueryBody, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
122
- remember: (request: RememberRequest, options?: RequestOptions) => Promise<{
123
- ids: string[];
124
- }>;
125
- list: (request?: PageRequest, options?: RequestOptions) => Promise<{
126
- nextCursor?: string;
127
- mems: Mem[];
128
- }>;
129
- read: (request: ReadRequest, execute?: Executor, options?: RequestOptions) => Promise<{
130
- mems: Mem[];
131
- }>;
132
- forget: (request: ForgetRequest, options?: RequestOptions) => Promise<void>;
133
- };
134
- branches: {
135
- create(request: {
136
- name: string;
137
- source?: {
138
- branch: string;
139
- } | undefined;
140
- }, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails>;
141
- list(options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails[]>;
142
- delete(branch: string, options?: RequestOptions): Promise<void>;
143
- };
144
- query(body: QueryBody, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
145
- read(request: ReadRequest, execute?: Executor, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
146
- mems: Mem[];
147
- }>;
148
- list(request?: PageRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
149
- nextCursor?: string;
150
- mems: Mem[];
151
- }>;
152
- remember(request: RememberRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
153
- ids: string[];
154
- }>;
155
- forget(request: ForgetRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<void>;
156
- configure(request: ConfigureRequest, options?: RequestOptions): Promise<void>;
157
- destroy(options?: RequestOptions): Promise<void>;
158
- };
159
- export declare function createBackend(options: CreateBackendOptions, requestOptions?: RequestOptions): Promise<{
160
- readonly metadataSchema: MetadataSchema;
161
- readonly textSearch: TextSearch | undefined;
162
- readonly embedding: Readonly<EmbeddingConfig>;
163
- readonly generation: number;
164
- assertActive: () => void;
165
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
166
- describeDescriptor(options?: RequestOptions): Promise<DriveDescriptor>;
167
- at(branch: string): {
168
- readonly metadataSchema: MetadataSchema;
169
- readonly textSearch: TextSearch | undefined;
170
- readonly embedding: Readonly<EmbeddingConfig>;
171
- readonly generation: number;
172
- assertActive: () => void;
173
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
174
- describeDescriptor: (options?: RequestOptions) => Promise<DriveDescriptor>;
175
- query(body: QueryBody, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
176
- remember: (request: RememberRequest, options?: RequestOptions) => Promise<{
177
- ids: string[];
178
- }>;
179
- list: (request?: PageRequest, options?: RequestOptions) => Promise<{
180
- nextCursor?: string;
181
- mems: Mem[];
182
- }>;
183
- read: (request: ReadRequest, execute?: Executor, options?: RequestOptions) => Promise<{
184
- mems: Mem[];
185
- }>;
186
- forget: (request: ForgetRequest, options?: RequestOptions) => Promise<void>;
187
- };
188
- branches: {
189
- create(request: {
190
- name: string;
191
- source?: {
192
- branch: string;
193
- } | undefined;
194
- }, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails>;
195
- list(options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails[]>;
196
- delete(branch: string, options?: RequestOptions): Promise<void>;
197
- };
198
- query(body: QueryBody, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
199
- read(request: ReadRequest, execute?: Executor, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
200
- mems: Mem[];
201
- }>;
202
- list(request?: PageRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
203
- nextCursor?: string;
204
- mems: Mem[];
205
- }>;
206
- remember(request: RememberRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
207
- ids: string[];
208
- }>;
209
- forget(request: ForgetRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<void>;
210
- configure(request: ConfigureRequest, options?: RequestOptions): Promise<void>;
211
- destroy(options?: RequestOptions): Promise<void>;
212
- }>;
213
- export declare function openBackend(options: Connection, requestOptions?: RequestOptions): Promise<{
214
- readonly metadataSchema: MetadataSchema;
215
- readonly textSearch: TextSearch | undefined;
216
- readonly embedding: Readonly<EmbeddingConfig>;
217
- readonly generation: number;
218
- assertActive: () => void;
219
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
220
- describeDescriptor(options?: RequestOptions): Promise<DriveDescriptor>;
221
- at(branch: string): {
222
- readonly metadataSchema: MetadataSchema;
223
- readonly textSearch: TextSearch | undefined;
224
- readonly embedding: Readonly<EmbeddingConfig>;
225
- readonly generation: number;
226
- assertActive: () => void;
227
- describe: (options?: RequestOptions) => Promise<import("@functional-systems/lambdadb").GetCollectionResponseWithDates>;
228
- describeDescriptor: (options?: RequestOptions) => Promise<DriveDescriptor>;
229
- query(body: QueryBody, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
230
- remember: (request: RememberRequest, options?: RequestOptions) => Promise<{
231
- ids: string[];
232
- }>;
233
- list: (request?: PageRequest, options?: RequestOptions) => Promise<{
234
- nextCursor?: string;
235
- mems: Mem[];
236
- }>;
237
- read: (request: ReadRequest, execute?: Executor, options?: RequestOptions) => Promise<{
238
- mems: Mem[];
239
- }>;
240
- forget: (request: ForgetRequest, options?: RequestOptions) => Promise<void>;
241
- };
242
- branches: {
243
- create(request: {
244
- name: string;
245
- source?: {
246
- branch: string;
247
- } | undefined;
248
- }, options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails>;
249
- list(options?: RequestOptions): Promise<import("@functional-systems/lambdadb").BranchDetails[]>;
250
- delete(branch: string, options?: RequestOptions): Promise<void>;
251
- };
252
- query(body: QueryBody, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<import("@functional-systems/lambdadb").QueryCollectionResponse>;
253
- read(request: ReadRequest, execute?: Executor, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
254
- mems: Mem[];
255
- }>;
256
- list(request?: PageRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
257
- nextCursor?: string;
258
- mems: Mem[];
259
- }>;
260
- remember(request: RememberRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<{
261
- ids: string[];
262
- }>;
263
- forget(request: ForgetRequest, options?: RequestOptions, branch?: string, assertActive?: () => void): Promise<void>;
264
- configure(request: ConfigureRequest, options?: RequestOptions): Promise<void>;
265
- destroy(options?: RequestOptions): Promise<void>;
266
- }>;
267
- export declare function listBackends(request: CatalogRequest, options?: RequestOptions): Promise<{
268
- nextCursor?: string;
269
- drives: DriveDescriptor[];
270
- }>;
271
- export type Backend = ReturnType<typeof backend>;
272
- export type DataBackend = Backend | ReturnType<Backend['at']>;
273
- export {};
274
- //# sourceMappingURL=storage.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"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"}