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

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 (107) hide show
  1. package/README.md +42 -13
  2. package/dist/commonjs/index.d.ts +2 -2
  3. package/dist/commonjs/index.d.ts.map +1 -1
  4. package/dist/commonjs/index.js +6 -34
  5. package/dist/commonjs/index.js.map +1 -1
  6. package/dist/commonjs/recall-input.d.ts +8 -0
  7. package/dist/commonjs/recall-input.d.ts.map +1 -0
  8. package/dist/commonjs/recall-input.js +45 -0
  9. package/dist/commonjs/recall-input.js.map +1 -0
  10. package/dist/commonjs/retriever/index.d.ts +7 -0
  11. package/dist/commonjs/retriever/index.d.ts.map +1 -0
  12. package/dist/commonjs/retriever/index.js +167 -0
  13. package/dist/commonjs/retriever/index.js.map +1 -0
  14. package/dist/commonjs/retriever/scope.d.ts +5 -0
  15. package/dist/commonjs/retriever/scope.d.ts.map +1 -0
  16. package/dist/commonjs/retriever/scope.js +69 -0
  17. package/dist/commonjs/retriever/scope.js.map +1 -0
  18. package/dist/commonjs/retriever/types.d.ts +89 -0
  19. package/dist/commonjs/retriever/types.d.ts.map +1 -0
  20. package/dist/commonjs/retriever/types.js +3 -0
  21. package/dist/commonjs/retriever/types.js.map +1 -0
  22. package/dist/commonjs/tools/definitions.d.ts +1 -1
  23. package/dist/commonjs/tools/definitions.d.ts.map +1 -1
  24. package/dist/commonjs/tools/definitions.js +30 -12
  25. package/dist/commonjs/tools/definitions.js.map +1 -1
  26. package/dist/commonjs/tools/evidence-ids.d.ts +7 -0
  27. package/dist/commonjs/tools/evidence-ids.d.ts.map +1 -0
  28. package/dist/commonjs/tools/evidence-ids.js +71 -0
  29. package/dist/commonjs/tools/evidence-ids.js.map +1 -0
  30. package/dist/commonjs/tools/factory.d.ts +7 -0
  31. package/dist/commonjs/tools/factory.d.ts.map +1 -0
  32. package/dist/commonjs/tools/factory.js +169 -0
  33. package/dist/commonjs/tools/factory.js.map +1 -0
  34. package/dist/commonjs/tools/index.d.ts +1 -1
  35. package/dist/commonjs/tools/index.d.ts.map +1 -1
  36. package/dist/commonjs/tools/index.js +19 -98
  37. package/dist/commonjs/tools/index.js.map +1 -1
  38. package/dist/commonjs/tools/internal-types.d.ts +18 -0
  39. package/dist/commonjs/tools/internal-types.d.ts.map +1 -0
  40. package/dist/commonjs/tools/internal-types.js +3 -0
  41. package/dist/commonjs/tools/internal-types.js.map +1 -0
  42. package/dist/commonjs/tools/short-ids.d.ts +8 -0
  43. package/dist/commonjs/tools/short-ids.d.ts.map +1 -0
  44. package/dist/commonjs/tools/short-ids.js +81 -0
  45. package/dist/commonjs/tools/short-ids.js.map +1 -0
  46. package/dist/commonjs/tools/types.d.ts +3 -0
  47. package/dist/commonjs/tools/types.d.ts.map +1 -1
  48. package/dist/esm/index.d.ts +2 -2
  49. package/dist/esm/index.d.ts.map +1 -1
  50. package/dist/esm/index.js +5 -33
  51. package/dist/esm/index.js.map +1 -1
  52. package/dist/esm/recall-input.d.ts +8 -0
  53. package/dist/esm/recall-input.d.ts.map +1 -0
  54. package/dist/esm/recall-input.js +40 -0
  55. package/dist/esm/recall-input.js.map +1 -0
  56. package/dist/esm/retriever/index.d.ts +7 -0
  57. package/dist/esm/retriever/index.d.ts.map +1 -0
  58. package/dist/esm/retriever/index.js +163 -0
  59. package/dist/esm/retriever/index.js.map +1 -0
  60. package/dist/esm/retriever/scope.d.ts +5 -0
  61. package/dist/esm/retriever/scope.d.ts.map +1 -0
  62. package/dist/esm/retriever/scope.js +66 -0
  63. package/dist/esm/retriever/scope.js.map +1 -0
  64. package/dist/esm/retriever/types.d.ts +89 -0
  65. package/dist/esm/retriever/types.d.ts.map +1 -0
  66. package/dist/esm/retriever/types.js +2 -0
  67. package/dist/esm/retriever/types.js.map +1 -0
  68. package/dist/esm/tools/definitions.d.ts +1 -1
  69. package/dist/esm/tools/definitions.d.ts.map +1 -1
  70. package/dist/esm/tools/definitions.js +30 -12
  71. package/dist/esm/tools/definitions.js.map +1 -1
  72. package/dist/esm/tools/evidence-ids.d.ts +7 -0
  73. package/dist/esm/tools/evidence-ids.d.ts.map +1 -0
  74. package/dist/esm/tools/evidence-ids.js +68 -0
  75. package/dist/esm/tools/evidence-ids.js.map +1 -0
  76. package/dist/esm/tools/factory.d.ts +7 -0
  77. package/dist/esm/tools/factory.d.ts.map +1 -0
  78. package/dist/esm/tools/factory.js +166 -0
  79. package/dist/esm/tools/factory.js.map +1 -0
  80. package/dist/esm/tools/index.d.ts +1 -1
  81. package/dist/esm/tools/index.d.ts.map +1 -1
  82. package/dist/esm/tools/index.js +19 -98
  83. package/dist/esm/tools/index.js.map +1 -1
  84. package/dist/esm/tools/internal-types.d.ts +18 -0
  85. package/dist/esm/tools/internal-types.d.ts.map +1 -0
  86. package/dist/esm/tools/internal-types.js +2 -0
  87. package/dist/esm/tools/internal-types.js.map +1 -0
  88. package/dist/esm/tools/short-ids.d.ts +8 -0
  89. package/dist/esm/tools/short-ids.d.ts.map +1 -0
  90. package/dist/esm/tools/short-ids.js +78 -0
  91. package/dist/esm/tools/short-ids.js.map +1 -0
  92. package/dist/esm/tools/types.d.ts +3 -0
  93. package/dist/esm/tools/types.d.ts.map +1 -1
  94. package/docs/tools.md +105 -4
  95. package/package.json +18 -5
  96. package/src/index.ts +6 -36
  97. package/src/recall-input.ts +46 -0
  98. package/src/retriever/index.ts +142 -0
  99. package/src/retriever/scope.ts +56 -0
  100. package/src/retriever/types.ts +68 -0
  101. package/src/tools/definitions.ts +30 -11
  102. package/src/tools/evidence-ids.ts +57 -0
  103. package/src/tools/factory.ts +153 -0
  104. package/src/tools/index.ts +21 -93
  105. package/src/tools/internal-types.ts +12 -0
  106. package/src/tools/short-ids.ts +58 -0
  107. package/src/tools/types.ts +3 -0
@@ -0,0 +1,69 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.scopedDrive = scopedDrive;
4
+ const errors_js_1 = require("../errors.js");
5
+ const recall_input_js_1 = require("../recall-input.js");
6
+ const filter_js_1 = require("../filter.js");
7
+ /** Scope limits data exposed by this orchestration, not authorization of the underlying handle. */
8
+ function scopedDrive(drive, request, descriptor, usage, reserve) {
9
+ const excluded = new Set(request.excludeIds ?? []);
10
+ const allowed = (mem) => !excluded.has(mem.id) && (0, filter_js_1.matchesFilter)(mem, request.filter, descriptor.metadataSchema);
11
+ const narrow = (input) => {
12
+ (0, errors_js_1.requireInput)(input.excludeIds === undefined || (Array.isArray(input.excludeIds) && input.excludeIds.every(id => typeof id === 'string' && id.trim())
13
+ && new Set(input.excludeIds).size === input.excludeIds.length), 'excludeIds must contain distinct canonical IDs.');
14
+ (0, filter_js_1.validateFilter)(input.filter, descriptor.metadataSchema);
15
+ return { ...input,
16
+ filter: request.filter && input.filter ? { and: [request.filter, input.filter] } : request.filter ?? input.filter,
17
+ excludeIds: [...new Set([...excluded, ...(input.excludeIds ?? [])])],
18
+ };
19
+ };
20
+ async function recall(input, options) {
21
+ const batch = 'requests' in input;
22
+ const requests = batch ? input.requests : [input];
23
+ reserve(requests.length);
24
+ const previousRequests = usage.databaseRequests;
25
+ // Until the call settles, cancellation cannot claim an exact native request total.
26
+ usage.databaseRequests = null;
27
+ let result;
28
+ try {
29
+ result = await drive.recall({ requests: requests.map(item => {
30
+ // Invalid items retain SDK batch error/cancellation semantics and cannot dispatch.
31
+ try {
32
+ (0, recall_input_js_1.recallInput)(item, descriptor.metadataSchema, descriptor.embedding);
33
+ }
34
+ catch {
35
+ return item;
36
+ }
37
+ return narrow(item);
38
+ }) }, options);
39
+ }
40
+ catch (error) {
41
+ usage.databaseRequests = null;
42
+ throw error;
43
+ }
44
+ usage.databaseRequests = previousRequests;
45
+ for (const item of result.results) {
46
+ usage.knownRecallDatabaseRequests += item.usage.databaseRequests;
47
+ if (usage.databaseRequests !== null)
48
+ usage.databaseRequests += item.usage.databaseRequests;
49
+ }
50
+ return batch ? result : result.results[0];
51
+ }
52
+ const uncounted = () => { reserve(1); usage.databaseRequests = null; };
53
+ let initial = true;
54
+ return { ...drive, recall,
55
+ describe: async (options) => {
56
+ // createTools already has the constructor's validated descriptor; explicit model calls refresh it.
57
+ if (initial) {
58
+ initial = false;
59
+ return structuredClone(descriptor);
60
+ }
61
+ uncounted();
62
+ return drive.describe(options);
63
+ },
64
+ read: async (input, options) => { uncounted(); const result = await drive.read(input, options); return { mems: result.mems.filter(allowed) }; },
65
+ list: async (input, options) => { uncounted(); const result = await drive.list(input, options); return { ...result, mems: result.mems.filter(allowed) }; },
66
+ countValues: async (input, options) => { uncounted(); return drive.countValues(narrow(input), options); },
67
+ };
68
+ }
69
+ //# sourceMappingURL=scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/retriever/scope.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/retriever/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/retriever/types.ts"],"names":[],"mappings":""}
@@ -1,5 +1,5 @@
1
1
  import type { DriveDescriptor } from '../types.js';
2
2
  import type { ToolDefinition } from './types.js';
3
3
  /** Common definitions for direct tool calling and MCP; no provider wire format. */
4
- export declare function toolDefinitions(descriptor: DriveDescriptor, writable?: boolean): ToolDefinition[];
4
+ export declare function toolDefinitions(descriptor: DriveDescriptor, writable?: boolean, shortIds?: boolean, evidenceIds?: boolean, retrieval?: boolean): ToolDefinition[];
5
5
  //# sourceMappingURL=definitions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAc,cAAc,EAAY,MAAM,YAAY,CAAC;AAyEvE,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,UAAQ,GAAG,cAAc,EAAE,CAgF/F"}
1
+ {"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAc,cAAc,EAAY,MAAM,YAAY,CAAC;AAyEvE,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,UAAQ,EAAE,QAAQ,UAAQ,EAAE,WAAW,UAAQ,EAAE,SAAS,UAAQ,GAAG,cAAc,EAAE,CAmGzJ"}
@@ -67,12 +67,14 @@ function resultSchema(value) {
67
67
  ] };
68
68
  }
69
69
  /** Common definitions for direct tool calling and MCP; no provider wire format. */
70
- function toolDefinitions(descriptor, writable = false) {
70
+ function toolDefinitions(descriptor, writable = false, shortIds = false, evidenceIds = false, retrieval = false) {
71
71
  const external = descriptor.embedding.mode === 'external';
72
72
  const vector = array({ type: 'number' }, { minItems: descriptor.embedding.dimensions,
73
73
  maxItems: descriptor.embedding.dimensions, description: 'Caller-supplied embedding in this drive\'s vector space. Do not invent vector coordinates.' });
74
74
  const filter = { $ref: '#/$defs/filter', description: 'Narrow by id, timestamp or declared metadata. Use explicit and/or arrays. Array eq/in test membership; neq requires a stored value and excludes matching elements. Discover fields with memdrive_describe.' };
75
- const exclusions = array(id, { uniqueItems: true, description: 'Exclude each canonical Mem ID and all of its chunks. This excludes whole memories, not only previously seen chunks; do not use temporary aliases.' });
75
+ const exclusions = array(id, { uniqueItems: true, description: shortIds
76
+ ? 'Exclude each returned session memory ID and all of its chunks, not only previously seen excerpts.'
77
+ : 'Exclude each canonical Mem ID and all of its chunks. This excludes whole memories, not only previously seen chunks; do not use temporary aliases.' });
76
78
  const request = object({
77
79
  ...(external ? { queryVector: vector } : {
78
80
  query: { type: 'string', minLength: 1, description: 'Question or search terms. Cannot be the exact match-all expression *:*. Query and constructed context each have an 8 KiB native limit.' },
@@ -84,29 +86,45 @@ function toolDefinitions(descriptor, writable = false) {
84
86
  rerank: external ? { const: false, description: 'External vectors do not support reranking; omit or pass false.' }
85
87
  : { type: 'boolean', description: 'Use native reranking; default true. False preserves native search order.' },
86
88
  }, [external ? 'queryVector' : 'query']);
89
+ const evidence = evidenceIds ? { evidenceId: string('Session evidence reference (e1, e2, ...); use for citations, not memory-ID inputs.') } : {};
90
+ const evidenceRequired = evidenceIds ? ['evidenceId'] : [];
87
91
  const match = external
88
- ? object({ kind: { const: 'mem' }, memId: id, ...attributes }, ['kind', 'memId'])
92
+ ? object({ kind: { const: 'mem' }, memId: id, ...attributes, ...evidence }, ['kind', 'memId', ...evidenceRequired])
89
93
  : object({ kind: { type: 'string', enum: ['mem', 'chunk'] }, memId: id, content: string(),
90
- start: { type: 'integer', minimum: 0 }, end: { type: 'integer', minimum: 1 }, ...attributes }, ['kind', 'memId', 'content', 'start', 'end']);
91
- const mem = object({ id, ...(!external ? { content: string() } : {}), ...attributes }, external ? ['id'] : ['id', 'content']);
92
- const recallResult = { anyOf: [object({ matches: array(match), usage }, ['matches', 'usage']),
93
- object({ error: object({ code: string(), message: string(), status: { type: 'integer' } }, ['code', 'message']), usage }, ['error', 'usage'])] };
94
+ start: { type: 'integer', minimum: 0 }, end: { type: 'integer', minimum: 1 }, ...attributes, ...evidence }, ['kind', 'memId', 'content', 'start', 'end', ...evidenceRequired]);
95
+ const mem = object({ id, ...(!external ? { content: string() } : {}), ...attributes, ...evidence }, [...(external ? ['id'] : ['id', 'content']), ...evidenceRequired]);
96
+ const completion = object({ status: { enum: ['completed', 'budget_exhausted', 'aborted', 'failed'] }, reason: string() }, ['status']);
97
+ const counts = Object.fromEntries(['knownRecallDatabaseRequests', 'dataCalls', 'toolCalls', 'modelCalls', 'inputTokens', 'outputTokens', 'unknownUsageCalls']
98
+ .map(key => [key, { type: 'integer', minimum: 0 }]));
99
+ const retrievalUsage = object({ elapsedMs: { type: 'number', minimum: 0 }, databaseRequests: { type: ['integer', 'null'], minimum: 0 }, ...counts }, ['elapsedMs', 'databaseRequests', ...Object.keys(counts)]);
100
+ const resultUsage = retrieval ? retrievalUsage : usage;
101
+ const completionFields = retrieval ? { completion } : {};
102
+ const requiredCompletion = retrieval ? ['completion'] : [];
103
+ const recallResult = { anyOf: [object({ matches: array(match), usage: resultUsage, ...completionFields }, ['matches', 'usage', ...requiredCompletion]),
104
+ object({ error: object({ code: string(), message: string(), status: { type: 'integer' } }, ['code', 'message']), usage: resultUsage, ...completionFields }, ['error', 'usage', ...requiredCompletion])] };
94
105
  const countable = ['id', ...Object.entries(descriptor.metadataSchema)
95
106
  .filter(([, field]) => field.type === 'string' || field.type === 'string[]').map(([name]) => `metadata.${name}`)];
96
107
  const define = (name, title, description, input, output, hasFilter = false, write = false) => ({
97
- name, title, description,
108
+ name, title, description: (shortIds && name !== 'memdrive_describe'
109
+ ? description.replaceAll('canonical ', '').replaceAll('Canonical ', '')
110
+ + ' Memory IDs are session aliases (m1, m2, ...). Reuse only returned aliases; raw IDs and invented aliases are rejected.'
111
+ : description) + (evidenceIds && ['memdrive_recall', 'memdrive_read', 'memdrive_list'].includes(name)
112
+ ? ' evidenceId identifies this exact returned evidence; reuse it for citations. Memory-ID inputs still use memId/id.' : ''),
98
113
  inputSchema: { $schema: dialect, ...input, ...(hasFilter ? { $defs: { filter: filterDefinition(descriptor.metadataSchema) } } : {}) },
99
114
  outputSchema: resultSchema(output),
100
115
  annotations: { readOnlyHint: !write, destructiveHint: !!write, idempotentHint: write !== 'remember', openWorldHint: false },
101
116
  });
102
117
  const definitions = [
103
- define('memdrive_recall', 'Search memories', external
104
- ? 'Search this drive with caller-supplied vectors; submit one to five independent requests, returned in input order. Results contain canonical memId values and metadata, without vectors or source text; the caller reconstructs originals. Inspect per-request errors and refine the supplied query when more evidence is needed.'
105
- : `Search stored memories for evidence relevant to one to five questions using ${descriptor.textSearch ? 'hybrid keyword and vector' : 'vector'} retrieval, with native reranking enabled by default. Independent requests run concurrently and results retain input order; kind mem is a complete original, while kind chunk is an excerpt with UTF-16 start/end offsets and memId identifies the original for memdrive_read. When evidence is missing, query the missing facts or narrow filters; results are not an answer and previous searches are not automatically excluded.`, object({ requests: array(request, { minItems: 1, maxItems: 5,
118
+ define('memdrive_recall', 'Search memories', retrieval
119
+ ? 'Retrieve source evidence for 1 to 5 independent requests using the host-configured strategy. Requests run concurrently with isolated per-request budgets. Results preserve input order. Check each completion.status; incomplete retrieval returns no fallback matches. Model and strategy settings cannot be changed through tool arguments.'
120
+ : external
121
+ ? 'Search this drive with caller-supplied vectors; submit one to five independent requests, returned in input order. Results contain canonical memId values and metadata, without vectors or source text; the caller reconstructs originals. Inspect per-request errors and refine the supplied query when more evidence is needed.'
122
+ : `Search stored memories for evidence relevant to one to five questions using ${descriptor.textSearch ? 'hybrid keyword and vector' : 'vector'} retrieval, with native reranking enabled by default. Independent requests run concurrently and results retain input order; kind mem is a complete original, while kind chunk is an excerpt with UTF-16 start/end offsets and memId identifies the original for memdrive_read. When evidence is missing, query the missing facts or narrow filters; results are not an answer and previous searches are not automatically excluded.`, object({ requests: array(request, { minItems: 1, maxItems: 5,
106
123
  description: 'Independent search requests; returned results correspond to this array by index.' }) }, ['requests']), object({ results: array(recallResult, { minItems: 1, maxItems: 5 }) }, ['results']), true),
107
124
  define('memdrive_read', 'Read original memories', external
108
125
  ? 'Read canonical memory references and metadata by ID. External-vector memories return neither source text nor vectors; the caller owns source reconstruction. Missing IDs are omitted.'
109
- : 'Read complete originals by canonical Mem ID when an excerpt needs surrounding context. Use memId from search results; kind mem already contains the complete original and needs no additional read. Missing IDs are omitted and originals are not truncated.', object({ ids: ids('Canonical Mem IDs to read, usually matches[].memId from memdrive_recall.') }, ['ids']), object({ mems: array(mem) }, ['mems'])),
126
+ : 'Read complete originals by canonical Mem ID when an excerpt needs surrounding context. Use memId from search results; kind mem already contains the complete original and needs no additional read. Missing IDs are omitted and originals are not truncated.', object({ ids: ids(shortIds ? 'Returned session memory IDs to read, usually matches[].memId from memdrive_recall.'
127
+ : 'Canonical Mem IDs to read, usually matches[].memId from memdrive_recall.') }, ['ids']), object({ mems: array(mem) }, ['mems'])),
110
128
  define('memdrive_describe', 'Describe memory drive', 'Inspect the drive description, labels, declared metadata fields and their meanings, embedding configuration and text-search analyzers. Use this before constructing unfamiliar metadata filters or choosing fields to count. This is a fresh schema lookup, not a list of stored memories or metadata values.', object({}), descriptorSchema),
111
129
  define('memdrive_count_values', 'Count metadata values', 'Inspect value distributions for id or declared string/string[] metadata fields, over original memories rather than chunks. Filters and excluded Mem IDs restrict the population; an array can put one memory in multiple buckets, so bucket sums are not a memory total. Results may be cached for 60 seconds: asOf is the fetch time and hasMore=null means completeness is unknown at the native bucket limit.', object({ fields: array({ type: 'string', enum: countable }, { minItems: 1, maxItems: 5, uniqueItems: true,
112
130
  description: 'One to five keyword fields. Numeric, boolean and datetime fields can filter but cannot be counted.' }),
@@ -1 +1 @@
1
- {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/tools/definitions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/tools/definitions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { EvidenceReference } from './internal-types.js';
2
+ /** References identify returned source spans, not model delivery or answer selection. */
3
+ export declare function evidenceIds(external: boolean): {
4
+ resolve: (id: string) => EvidenceReference;
5
+ output: (name: string, value: Record<string, unknown>) => void;
6
+ };
7
+ //# sourceMappingURL=evidence-ids.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evidence-ids.d.ts","sourceRoot":"","sources":["../../../src/tools/evidence-ids.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO;kBAGpB,MAAM,KAAG,iBAAiB;mBA+BzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;EActE"}
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.evidenceIds = evidenceIds;
4
+ const errors_js_1 = require("../errors.js");
5
+ const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
6
+ const canonical = (value) => Array.isArray(value) ? value.map(canonical)
7
+ : object(value) ? Object.fromEntries(Object.keys(value).sort().map(key => [key, canonical(value[key])])) : value;
8
+ /** References identify returned source spans, not model delivery or answer selection. */
9
+ function evidenceIds(external) {
10
+ const references = new Map();
11
+ const sources = new Map();
12
+ const resolve = (id) => {
13
+ const reference = references.get(id);
14
+ if (!reference)
15
+ throw new errors_js_1.MemDriveError('INVALID_INPUT', 'Use an evidence ID returned by this tool session.');
16
+ return { ...reference };
17
+ };
18
+ const attach = (items, originals) => {
19
+ const pending = new Map();
20
+ const rows = items.map(value => {
21
+ if (!object(value))
22
+ throw new errors_js_1.MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence.');
23
+ const memId = originals ? value.id : value.memId;
24
+ if (typeof memId !== 'string')
25
+ throw new errors_js_1.MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence.');
26
+ const start = originals ? 0 : value.start, end = originals && typeof value.content === 'string' ? value.content.length : value.end;
27
+ if (!external && !(typeof value.content === 'string' && Number.isSafeInteger(start) && Number.isSafeInteger(end)
28
+ && start >= 0 && end > start && value.content.length === end - start))
29
+ throw new errors_js_1.MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence bounds.');
30
+ const reference = external ? { memId } : { memId, start: start, end: end };
31
+ const key = JSON.stringify(reference);
32
+ const signature = JSON.stringify(canonical({ content: value.content, timestamp: value.timestamp, metadata: value.metadata }));
33
+ const previous = sources.get(key) ?? pending.get(key);
34
+ if (previous && previous.signature !== signature)
35
+ throw new errors_js_1.MemDriveError('INVALID_RESULT', 'Source changed for an evidence ID in this tool session.');
36
+ pending.set(key, { reference, signature });
37
+ return { value, key };
38
+ });
39
+ // Validate the whole result first: a failed item must not allocate unreturned aliases.
40
+ for (const [key, entry] of pending)
41
+ if (!sources.has(key)) {
42
+ const alias = `e${references.size + 1}`;
43
+ sources.set(key, { alias, signature: entry.signature });
44
+ references.set(alias, entry.reference);
45
+ }
46
+ for (const { value, key } of rows)
47
+ value.evidenceId = sources.get(key).alias;
48
+ };
49
+ const output = (name, value) => {
50
+ if (name === 'memdrive_recall' && Array.isArray(value.results)) {
51
+ value.results = value.results.map(item => {
52
+ if (!object(item) || !Array.isArray(item.matches))
53
+ return item;
54
+ try {
55
+ attach(item.matches, false);
56
+ return item;
57
+ }
58
+ catch (cause) {
59
+ if (!(cause instanceof errors_js_1.MemDriveError))
60
+ throw cause;
61
+ return { error: { code: cause.code, message: cause.message }, usage: item.usage,
62
+ ...(item.completion === undefined ? {} : { completion: { status: 'failed', reason: cause.code } }) };
63
+ }
64
+ });
65
+ }
66
+ else if ((name === 'memdrive_read' || name === 'memdrive_list') && Array.isArray(value.mems))
67
+ attach(value.mems, true);
68
+ };
69
+ return { resolve, output };
70
+ }
71
+ //# sourceMappingURL=evidence-ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evidence-ids.js","sourceRoot":"","sources":["../../../src/tools/evidence-ids.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { Retriever } from '../retriever/types.js';
2
+ import type { MemDrive } from '../types.js';
3
+ import type { RequestOptions } from '../types.js';
4
+ import type { InternalToolsOptions, InternalMemoryTools } from './internal-types.js';
5
+ /** Shared primitive factory. Internal retrieval sessions never provide configureRecall. */
6
+ export declare function createMemoryTools(configuration: InternalToolsOptions, options?: RequestOptions, configureRecall?: (drive: MemDrive) => Promise<Retriever>): Promise<InternalMemoryTools>;
7
+ //# sourceMappingURL=factory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tools/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAA2E,cAAc,EAAE,MAAM,aAAa,CAAC;AAK3H,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA4BrF,2FAA2F;AAC3F,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,GAAE,cAAmB,EACrG,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkH3F"}
@@ -0,0 +1,169 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createMemoryTools = createMemoryTools;
4
+ const errors_js_1 = require("../errors.js");
5
+ const definitions_js_1 = require("./definitions.js");
6
+ const evidence_ids_js_1 = require("./evidence-ids.js");
7
+ const short_ids_js_1 = require("./short-ids.js");
8
+ const object = (value) => value !== null
9
+ && typeof value === 'object' && !Array.isArray(value)
10
+ && [Object.prototype, null].includes(Object.getPrototypeOf(value));
11
+ function requireInput(condition, message) {
12
+ if (!condition)
13
+ throw new errors_js_1.MemDriveError('INVALID_INPUT', message);
14
+ }
15
+ function checkAbort(options) {
16
+ if (options.signal?.aborted)
17
+ throw new errors_js_1.MemDriveError('ABORTED', 'Operation aborted.');
18
+ }
19
+ function errorResult(cause) {
20
+ if (!(cause instanceof errors_js_1.MemDriveError))
21
+ return { ok: false,
22
+ error: { code: 'TOOL_EXECUTION_FAILED', message: 'Memory tool execution failed.' } };
23
+ const error = { code: cause.code, message: cause.message };
24
+ if (Number.isInteger(cause.status))
25
+ error.status = cause.status;
26
+ // Preserve actionable write outcomes, never transport details, causes or stacks.
27
+ if (cause.details) {
28
+ const details = {};
29
+ for (const key of ['completedIds', 'uncertainIds', 'notAttemptedIds']) {
30
+ const value = cause.details[key];
31
+ if (Array.isArray(value) && value.every((id) => typeof id === 'string'))
32
+ details[key] = [...value];
33
+ }
34
+ if (Object.keys(details).length)
35
+ error.details = details;
36
+ }
37
+ return { ok: false, error };
38
+ }
39
+ /** Shared primitive factory. Internal retrieval sessions never provide configureRecall. */
40
+ async function createMemoryTools(configuration, options = {}, configureRecall) {
41
+ requireInput(object(configuration) && Object.keys(configuration).every(key => ['drive', 'branch', 'writable', 'shortIds', 'evidenceIds', 'retrieval'].includes(key)), 'Use drive, optional branch, writable, shortIds evidenceIds and optional retrieval to create memory tools.');
42
+ requireInput(configuration.writable === undefined || typeof configuration.writable === 'boolean', 'writable must be a boolean.');
43
+ requireInput(configuration.shortIds === undefined || typeof configuration.shortIds === 'boolean', 'shortIds must be a boolean.');
44
+ requireInput(configuration.evidenceIds === undefined || typeof configuration.evidenceIds === 'boolean', 'evidenceIds must be a boolean.');
45
+ const { drive, branch, writable = false, shortIds = false, evidenceIds = false } = configuration;
46
+ requireInput(!(shortIds || evidenceIds) || !writable, 'Session IDs require read-only memory tools.');
47
+ requireInput(drive && typeof drive.describe === 'function' && typeof drive.recall === 'function', 'Provide a MemDrive handle.');
48
+ const data = branch === undefined ? drive : drive.at({ branch });
49
+ const descriptor = await drive.describe(options);
50
+ checkAbort(options);
51
+ let initialDescriptor = true;
52
+ const retriever = configureRecall ? await configureRecall({ ...drive, ...data, describe: async (request) => {
53
+ if (initialDescriptor) {
54
+ initialDescriptor = false;
55
+ return structuredClone(descriptor);
56
+ }
57
+ return drive.describe(request);
58
+ } }) : undefined;
59
+ const definitions = (0, definitions_js_1.toolDefinitions)(descriptor, writable, shortIds, evidenceIds, !!retriever);
60
+ const ids = shortIds ? (0, short_ids_js_1.shortIds)() : undefined;
61
+ const evidence = evidenceIds ? (0, evidence_ids_js_1.evidenceIds)(descriptor.embedding.mode === 'external') : undefined;
62
+ const enabled = new Set(definitions.map(tool => tool.name));
63
+ return Object.freeze({
64
+ get definitions() { return structuredClone(definitions); },
65
+ resolveId: (id) => ids ? ids.resolve(id) : id,
66
+ resolveEvidence: (id) => {
67
+ if (!evidence)
68
+ throw new errors_js_1.MemDriveError('INVALID_INPUT', 'Evidence IDs are disabled for this tool session.');
69
+ return evidence.resolve(id);
70
+ },
71
+ async execute(name, input, requestOptions = {}) {
72
+ try {
73
+ requireInput(object(requestOptions) && Object.keys(requestOptions).every(key => key === 'signal'), 'Operation options accept only signal.');
74
+ checkAbort(requestOptions);
75
+ if (!enabled.has(name))
76
+ throw new errors_js_1.MemDriveError('UNKNOWN_TOOL', 'Unknown or disabled memory tool.');
77
+ requireInput(object(input), 'Tool arguments must be an object.');
78
+ // Detach inputs before any SDK operation can yield. No coercion or null stripping.
79
+ let args;
80
+ try {
81
+ args = structuredClone(input);
82
+ }
83
+ catch {
84
+ throw new errors_js_1.MemDriveError('INVALID_INPUT', 'Tool arguments must be cloneable data.');
85
+ }
86
+ let value;
87
+ switch (name) {
88
+ case 'memdrive_recall': {
89
+ requireInput(Object.keys(args).length === 1 && Array.isArray(args.requests)
90
+ && args.requests.length >= 1 && args.requests.length <= 5, 'recall requires requests containing 1 to 5 search requests.');
91
+ const aliasErrors = new Map();
92
+ if (ids)
93
+ args.requests.forEach((request, index) => {
94
+ try {
95
+ const translated = structuredClone(request);
96
+ ids.query(translated);
97
+ args.requests[index] = translated;
98
+ }
99
+ catch (cause) {
100
+ if (!(cause instanceof errors_js_1.MemDriveError))
101
+ throw cause;
102
+ aliasErrors.set(index, cause.message);
103
+ // Retain batch indices and SDK cancellation/validation order; {} cannot dispatch a query.
104
+ args.requests[index] = {};
105
+ }
106
+ });
107
+ const received = retriever ? { results: await Promise.all(args.requests.map(async (request) => {
108
+ try {
109
+ return await retriever.recall(request, requestOptions);
110
+ }
111
+ catch (cause) {
112
+ const failure = errorResult(cause);
113
+ if (failure.ok)
114
+ throw cause;
115
+ const native = cause instanceof errors_js_1.MemDriveError ? cause.usage?.databaseRequests : undefined;
116
+ return { error: failure.error, completion: { status: failure.error.code === 'ABORTED' ? 'aborted' : 'failed', reason: failure.error.code },
117
+ usage: { elapsedMs: cause instanceof errors_js_1.MemDriveError ? cause.usage?.elapsedMs ?? 0 : 0,
118
+ databaseRequests: native ?? (failure.error.code === 'INVALID_INPUT' ? 0 : null),
119
+ knownRecallDatabaseRequests: native ?? 0, dataCalls: native === undefined ? 0 : 1,
120
+ toolCalls: 0, modelCalls: 0, inputTokens: 0, outputTokens: 0, unknownUsageCalls: 0 } };
121
+ }
122
+ })) } : await data.recall({ requests: args.requests }, requestOptions);
123
+ const recalled = aliasErrors.size ? structuredClone(received) : received;
124
+ for (const [index, message] of aliasErrors) {
125
+ const item = recalled.results[index];
126
+ if (item && 'error' in item && item.error.code === 'INVALID_INPUT')
127
+ item.error.message = message;
128
+ }
129
+ value = recalled;
130
+ break;
131
+ }
132
+ case 'memdrive_read':
133
+ ids?.read(args);
134
+ value = await data.read(args, requestOptions);
135
+ break;
136
+ case 'memdrive_describe':
137
+ requireInput(Object.keys(args).length === 0, 'describe accepts an empty object.');
138
+ value = await drive.describe(requestOptions);
139
+ break;
140
+ case 'memdrive_count_values':
141
+ ids?.query(args);
142
+ value = await data.countValues(args, requestOptions);
143
+ break;
144
+ case 'memdrive_list':
145
+ value = await data.list(args, requestOptions);
146
+ break;
147
+ case 'memdrive_remember':
148
+ value = await data.remember(args, requestOptions);
149
+ break;
150
+ case 'memdrive_forget':
151
+ await data.forget(args, requestOptions);
152
+ value = { acknowledged: true };
153
+ break;
154
+ }
155
+ requireInput(object(value), 'Memory tool returned an invalid result.');
156
+ // Preserve settled SDK outcomes, including completed items in a canceled batch.
157
+ // SDK outputs are JSON data. Every transport receives the same detached value.
158
+ const detached = structuredClone(value);
159
+ evidence?.output(name, detached);
160
+ ids?.output(name, detached);
161
+ return { ok: true, value: detached };
162
+ }
163
+ catch (cause) {
164
+ return errorResult(cause);
165
+ }
166
+ },
167
+ });
168
+ }
169
+ //# sourceMappingURL=factory.js.map