@functional-systems/memdrive 0.1.0 → 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 +79 -19
  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,68 @@
1
+ import { MemDriveError } from '../errors.js';
2
+ const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
3
+ const canonical = (value) => Array.isArray(value) ? value.map(canonical)
4
+ : object(value) ? Object.fromEntries(Object.keys(value).sort().map(key => [key, canonical(value[key])])) : value;
5
+ /** References identify returned source spans, not model delivery or answer selection. */
6
+ export function evidenceIds(external) {
7
+ const references = new Map();
8
+ const sources = new Map();
9
+ const resolve = (id) => {
10
+ const reference = references.get(id);
11
+ if (!reference)
12
+ throw new MemDriveError('INVALID_INPUT', 'Use an evidence ID returned by this tool session.');
13
+ return { ...reference };
14
+ };
15
+ const attach = (items, originals) => {
16
+ const pending = new Map();
17
+ const rows = items.map(value => {
18
+ if (!object(value))
19
+ throw new MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence.');
20
+ const memId = originals ? value.id : value.memId;
21
+ if (typeof memId !== 'string')
22
+ throw new MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence.');
23
+ const start = originals ? 0 : value.start, end = originals && typeof value.content === 'string' ? value.content.length : value.end;
24
+ if (!external && !(typeof value.content === 'string' && Number.isSafeInteger(start) && Number.isSafeInteger(end)
25
+ && start >= 0 && end > start && value.content.length === end - start))
26
+ throw new MemDriveError('INVALID_RESULT', 'Memory tool returned invalid evidence bounds.');
27
+ const reference = external ? { memId } : { memId, start: start, end: end };
28
+ const key = JSON.stringify(reference);
29
+ const signature = JSON.stringify(canonical({ content: value.content, timestamp: value.timestamp, metadata: value.metadata }));
30
+ const previous = sources.get(key) ?? pending.get(key);
31
+ if (previous && previous.signature !== signature)
32
+ throw new MemDriveError('INVALID_RESULT', 'Source changed for an evidence ID in this tool session.');
33
+ pending.set(key, { reference, signature });
34
+ return { value, key };
35
+ });
36
+ // Validate the whole result first: a failed item must not allocate unreturned aliases.
37
+ for (const [key, entry] of pending)
38
+ if (!sources.has(key)) {
39
+ const alias = `e${references.size + 1}`;
40
+ sources.set(key, { alias, signature: entry.signature });
41
+ references.set(alias, entry.reference);
42
+ }
43
+ for (const { value, key } of rows)
44
+ value.evidenceId = sources.get(key).alias;
45
+ };
46
+ const output = (name, value) => {
47
+ if (name === 'memdrive_recall' && Array.isArray(value.results)) {
48
+ value.results = value.results.map(item => {
49
+ if (!object(item) || !Array.isArray(item.matches))
50
+ return item;
51
+ try {
52
+ attach(item.matches, false);
53
+ return item;
54
+ }
55
+ catch (cause) {
56
+ if (!(cause instanceof MemDriveError))
57
+ throw cause;
58
+ return { error: { code: cause.code, message: cause.message }, usage: item.usage,
59
+ ...(item.completion === undefined ? {} : { completion: { status: 'failed', reason: cause.code } }) };
60
+ }
61
+ });
62
+ }
63
+ else if ((name === 'memdrive_read' || name === 'memdrive_list') && Array.isArray(value.mems))
64
+ attach(value.mems, true);
65
+ };
66
+ return { resolve, output };
67
+ }
68
+ //# 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,166 @@
1
+ import { MemDriveError } from '../errors.js';
2
+ import { toolDefinitions } from './definitions.js';
3
+ import { evidenceIds as createEvidenceIds } from './evidence-ids.js';
4
+ import { shortIds as createShortIds } from './short-ids.js';
5
+ const object = (value) => value !== null
6
+ && typeof value === 'object' && !Array.isArray(value)
7
+ && [Object.prototype, null].includes(Object.getPrototypeOf(value));
8
+ function requireInput(condition, message) {
9
+ if (!condition)
10
+ throw new MemDriveError('INVALID_INPUT', message);
11
+ }
12
+ function checkAbort(options) {
13
+ if (options.signal?.aborted)
14
+ throw new MemDriveError('ABORTED', 'Operation aborted.');
15
+ }
16
+ function errorResult(cause) {
17
+ if (!(cause instanceof MemDriveError))
18
+ return { ok: false,
19
+ error: { code: 'TOOL_EXECUTION_FAILED', message: 'Memory tool execution failed.' } };
20
+ const error = { code: cause.code, message: cause.message };
21
+ if (Number.isInteger(cause.status))
22
+ error.status = cause.status;
23
+ // Preserve actionable write outcomes, never transport details, causes or stacks.
24
+ if (cause.details) {
25
+ const details = {};
26
+ for (const key of ['completedIds', 'uncertainIds', 'notAttemptedIds']) {
27
+ const value = cause.details[key];
28
+ if (Array.isArray(value) && value.every((id) => typeof id === 'string'))
29
+ details[key] = [...value];
30
+ }
31
+ if (Object.keys(details).length)
32
+ error.details = details;
33
+ }
34
+ return { ok: false, error };
35
+ }
36
+ /** Shared primitive factory. Internal retrieval sessions never provide configureRecall. */
37
+ export async function createMemoryTools(configuration, options = {}, configureRecall) {
38
+ 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.');
39
+ requireInput(configuration.writable === undefined || typeof configuration.writable === 'boolean', 'writable must be a boolean.');
40
+ requireInput(configuration.shortIds === undefined || typeof configuration.shortIds === 'boolean', 'shortIds must be a boolean.');
41
+ requireInput(configuration.evidenceIds === undefined || typeof configuration.evidenceIds === 'boolean', 'evidenceIds must be a boolean.');
42
+ const { drive, branch, writable = false, shortIds = false, evidenceIds = false } = configuration;
43
+ requireInput(!(shortIds || evidenceIds) || !writable, 'Session IDs require read-only memory tools.');
44
+ requireInput(drive && typeof drive.describe === 'function' && typeof drive.recall === 'function', 'Provide a MemDrive handle.');
45
+ const data = branch === undefined ? drive : drive.at({ branch });
46
+ const descriptor = await drive.describe(options);
47
+ checkAbort(options);
48
+ let initialDescriptor = true;
49
+ const retriever = configureRecall ? await configureRecall({ ...drive, ...data, describe: async (request) => {
50
+ if (initialDescriptor) {
51
+ initialDescriptor = false;
52
+ return structuredClone(descriptor);
53
+ }
54
+ return drive.describe(request);
55
+ } }) : undefined;
56
+ const definitions = toolDefinitions(descriptor, writable, shortIds, evidenceIds, !!retriever);
57
+ const ids = shortIds ? createShortIds() : undefined;
58
+ const evidence = evidenceIds ? createEvidenceIds(descriptor.embedding.mode === 'external') : undefined;
59
+ const enabled = new Set(definitions.map(tool => tool.name));
60
+ return Object.freeze({
61
+ get definitions() { return structuredClone(definitions); },
62
+ resolveId: (id) => ids ? ids.resolve(id) : id,
63
+ resolveEvidence: (id) => {
64
+ if (!evidence)
65
+ throw new MemDriveError('INVALID_INPUT', 'Evidence IDs are disabled for this tool session.');
66
+ return evidence.resolve(id);
67
+ },
68
+ async execute(name, input, requestOptions = {}) {
69
+ try {
70
+ requireInput(object(requestOptions) && Object.keys(requestOptions).every(key => key === 'signal'), 'Operation options accept only signal.');
71
+ checkAbort(requestOptions);
72
+ if (!enabled.has(name))
73
+ throw new MemDriveError('UNKNOWN_TOOL', 'Unknown or disabled memory tool.');
74
+ requireInput(object(input), 'Tool arguments must be an object.');
75
+ // Detach inputs before any SDK operation can yield. No coercion or null stripping.
76
+ let args;
77
+ try {
78
+ args = structuredClone(input);
79
+ }
80
+ catch {
81
+ throw new MemDriveError('INVALID_INPUT', 'Tool arguments must be cloneable data.');
82
+ }
83
+ let value;
84
+ switch (name) {
85
+ case 'memdrive_recall': {
86
+ requireInput(Object.keys(args).length === 1 && Array.isArray(args.requests)
87
+ && args.requests.length >= 1 && args.requests.length <= 5, 'recall requires requests containing 1 to 5 search requests.');
88
+ const aliasErrors = new Map();
89
+ if (ids)
90
+ args.requests.forEach((request, index) => {
91
+ try {
92
+ const translated = structuredClone(request);
93
+ ids.query(translated);
94
+ args.requests[index] = translated;
95
+ }
96
+ catch (cause) {
97
+ if (!(cause instanceof MemDriveError))
98
+ throw cause;
99
+ aliasErrors.set(index, cause.message);
100
+ // Retain batch indices and SDK cancellation/validation order; {} cannot dispatch a query.
101
+ args.requests[index] = {};
102
+ }
103
+ });
104
+ const received = retriever ? { results: await Promise.all(args.requests.map(async (request) => {
105
+ try {
106
+ return await retriever.recall(request, requestOptions);
107
+ }
108
+ catch (cause) {
109
+ const failure = errorResult(cause);
110
+ if (failure.ok)
111
+ throw cause;
112
+ const native = cause instanceof MemDriveError ? cause.usage?.databaseRequests : undefined;
113
+ return { error: failure.error, completion: { status: failure.error.code === 'ABORTED' ? 'aborted' : 'failed', reason: failure.error.code },
114
+ usage: { elapsedMs: cause instanceof MemDriveError ? cause.usage?.elapsedMs ?? 0 : 0,
115
+ databaseRequests: native ?? (failure.error.code === 'INVALID_INPUT' ? 0 : null),
116
+ knownRecallDatabaseRequests: native ?? 0, dataCalls: native === undefined ? 0 : 1,
117
+ toolCalls: 0, modelCalls: 0, inputTokens: 0, outputTokens: 0, unknownUsageCalls: 0 } };
118
+ }
119
+ })) } : await data.recall({ requests: args.requests }, requestOptions);
120
+ const recalled = aliasErrors.size ? structuredClone(received) : received;
121
+ for (const [index, message] of aliasErrors) {
122
+ const item = recalled.results[index];
123
+ if (item && 'error' in item && item.error.code === 'INVALID_INPUT')
124
+ item.error.message = message;
125
+ }
126
+ value = recalled;
127
+ break;
128
+ }
129
+ case 'memdrive_read':
130
+ ids?.read(args);
131
+ value = await data.read(args, requestOptions);
132
+ break;
133
+ case 'memdrive_describe':
134
+ requireInput(Object.keys(args).length === 0, 'describe accepts an empty object.');
135
+ value = await drive.describe(requestOptions);
136
+ break;
137
+ case 'memdrive_count_values':
138
+ ids?.query(args);
139
+ value = await data.countValues(args, requestOptions);
140
+ break;
141
+ case 'memdrive_list':
142
+ value = await data.list(args, requestOptions);
143
+ break;
144
+ case 'memdrive_remember':
145
+ value = await data.remember(args, requestOptions);
146
+ break;
147
+ case 'memdrive_forget':
148
+ await data.forget(args, requestOptions);
149
+ value = { acknowledged: true };
150
+ break;
151
+ }
152
+ requireInput(object(value), 'Memory tool returned an invalid result.');
153
+ // Preserve settled SDK outcomes, including completed items in a canceled batch.
154
+ // SDK outputs are JSON data. Every transport receives the same detached value.
155
+ const detached = structuredClone(value);
156
+ evidence?.output(name, detached);
157
+ ids?.output(name, detached);
158
+ return { ok: true, value: detached };
159
+ }
160
+ catch (cause) {
161
+ return errorResult(cause);
162
+ }
163
+ },
164
+ });
165
+ }
166
+ //# sourceMappingURL=factory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/tools/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAI5D,MAAM,MAAM,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,KAAK,KAAK,IAAI;OAC5E,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;OAClD,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,SAAS,YAAY,CAAC,SAAkB,EAAE,OAAe;IACrD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AACD,SAAS,UAAU,CAAC,OAAuB;IACvC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,aAAa,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC1F,CAAC;AACD,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK;YACrD,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,+BAA+B,EAAE,EAAE,CAAC;IACzF,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACtE,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC;IACjE,iFAAiF;IACjF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,MAAM,OAAO,GAAsC,EAAE,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,iBAAiB,CAAU,EAAE,CAAC;YAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAmC,EAAE,UAA0B,EAAE,EACrG,eAAyD;IACzD,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAChK,2GAA2G,CAAC,CAAC;IACjH,YAAY,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,aAAa,CAAC,QAAQ,KAAK,SAAS,EAAE,6BAA6B,CAAC,CAAC;IACjI,YAAY,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,aAAa,CAAC,QAAQ,KAAK,SAAS,EAAE,6BAA6B,CAAC,CAAC;IACjI,YAAY,CAAC,aAAa,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,aAAa,CAAC,WAAW,KAAK,SAAS,EAAE,gCAAgC,CAAC,CAAC;IAC1I,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,aAAa,CAAC;IACjG,YAAY,CAAC,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,6CAA6C,CAAC,CAAC;IACrG,YAAY,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,4BAA4B,CAAC,CAAC;IAChI,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjD,UAAU,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,iBAAiB,GAAG,IAAI,CAAC;IAC7B,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;YACrG,IAAI,iBAAiB,EAAE,CAAC;gBAAC,iBAAiB,GAAG,KAAK,CAAC;gBAAC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;YACzF,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjB,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9F,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,WAAW,KAAK,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC1D,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACrD,eAAe,EAAE,CAAC,EAAU,EAAE,EAAE;YAC5B,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,kDAAkD,CAAC,CAAC;YAC5G,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAAc,EAAE,iBAAiC,EAAE;YAC3E,IAAI,CAAC;gBACD,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,EAAE,uCAAuC,CAAC,CAAC;gBAC5I,UAAU,CAAC,cAAc,CAAC,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAA4C,CAAC;oBAC1D,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAC;gBAChF,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,mCAAmC,CAAC,CAAC;gBACjE,mFAAmF;gBACnF,IAAI,IAA6B,CAAC;gBAClC,IAAI,CAAC;oBAAC,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;gBACtC,MAAM,CAAC;oBAAC,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,wCAAwC,CAAC,CAAC;gBAAC,CAAC;gBAC7F,IAAI,KAAc,CAAC;gBACnB,QAAQ,IAAI,EAAE,CAAC;oBACX,KAAK,iBAAiB,CAAC,CAAC,CAAC;wBACrB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;+BACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,EAC7D,6DAA6D,CAAC,CAAC;wBAC/D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;wBAC9C,IAAI,GAAG;4BAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gCAC9C,IAAI,CAAC;oCACD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;oCAC5C,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oCACrB,IAAI,CAAC,QAAsB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;gCACrD,CAAC;gCACD,OAAO,KAAK,EAAE,CAAC;oCACX,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC;wCAAE,MAAM,KAAK,CAAC;oCACnD,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;oCACtC,0FAA0F;oCACzF,IAAI,CAAC,QAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gCAC7C,CAAC;4BACL,CAAC,CAAC,CAAC;wBACH,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAE,IAAI,CAAC,QAA4B,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;gCAC7G,IAAI,CAAC;oCAAC,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gCAAC,CAAC;gCAC/D,OAAO,KAAK,EAAE,CAAC;oCACX,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;oCAAC,IAAI,OAAO,CAAC,EAAE;wCAAE,MAAM,KAAK,CAAC;oCAChE,MAAM,MAAM,GAAG,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;oCAC1F,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;wCACtI,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;4CAChF,gBAAgB,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;4CAC/E,2BAA2B,EAAE,MAAM,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;4CACjF,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC;gCACnG,CAAC;4BACL,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAA2B,EAAE,EAAE,cAAc,CAAC,CAAC;wBAC1F,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;wBACzE,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;4BACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;4BACrC,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe;gCAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;wBACrG,CAAC;wBACD,KAAK,GAAG,QAAQ,CAAC;wBACjB,MAAM;oBACV,CAAC;oBACD,KAAK,eAAe;wBAChB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;wBAChB,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAyB,EAAE,cAAc,CAAC,CAAC;wBACnE,MAAM;oBACV,KAAK,mBAAmB;wBACpB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,mCAAmC,CAAC,CAAC;wBAClF,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;wBAC7C,MAAM;oBACV,KAAK,uBAAuB;wBACxB,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;wBACjB,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAqC,EAAE,cAAc,CAAC,CAAC;wBACtF,MAAM;oBACV,KAAK,eAAe;wBAChB,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAmB,EAAE,cAAc,CAAC,CAAC;wBAC7D,MAAM;oBACV,KAAK,mBAAmB;wBACpB,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAA4B,EAAE,cAAc,CAAC,CAAC;wBAC1E,MAAM;oBACV,KAAK,iBAAiB;wBAClB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAgC,EAAE,cAAc,CAAC,CAAC;wBACpE,KAAK,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;wBAC/B,MAAM;gBACd,CAAC;gBACD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,yCAAyC,CAAC,CAAC;gBACvE,gFAAgF;gBAChF,+EAA+E;gBAC/E,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACxC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACjC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;KACJ,CAAC,CAAC;AACP,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import type { RequestOptions } from '../types.js';
2
2
  import type { CreateToolsOptions, MemoryTools } from './types.js';
3
3
  export type * from './types.js';
4
- /** Bind portable tools to an already authorized drive; no model or MCP runtime. */
4
+ /** Bind the existing tool catalog; optional orchestration changes only recall execution. */
5
5
  export declare function createTools(configuration: CreateToolsOptions, options?: RequestOptions): Promise<MemoryTools>;
6
6
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA2E,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3H,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAEzF,mBAAmB,YAAY,CAAC;AA4BhC,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,aAAa,EAAE,kBAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8DvH"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,mBAAmB,YAAY,CAAC;AAEhC,4FAA4F;AAC5F,wBAAsB,WAAW,CAAC,aAAa,EAAE,kBAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBvH"}
@@ -1,101 +1,22 @@
1
- import { MemDriveError } from '../index.js';
2
- import { toolDefinitions } from './definitions.js';
3
- const object = (value) => value !== null
4
- && typeof value === 'object' && !Array.isArray(value)
5
- && [Object.prototype, null].includes(Object.getPrototypeOf(value));
6
- function requireInput(condition, message) {
7
- if (!condition)
8
- throw new MemDriveError('INVALID_INPUT', message);
9
- }
10
- function checkAbort(options) {
11
- if (options.signal?.aborted)
12
- throw new MemDriveError('ABORTED', 'Operation aborted.');
13
- }
14
- function errorResult(cause) {
15
- if (!(cause instanceof MemDriveError))
16
- return { ok: false,
17
- error: { code: 'TOOL_EXECUTION_FAILED', message: 'Memory tool execution failed.' } };
18
- const error = { code: cause.code, message: cause.message };
19
- if (Number.isInteger(cause.status))
20
- error.status = cause.status;
21
- // Preserve actionable write outcomes, never transport details, causes or stacks.
22
- if (cause.details) {
23
- const details = {};
24
- for (const key of ['completedIds', 'uncertainIds', 'notAttemptedIds']) {
25
- const value = cause.details[key];
26
- if (Array.isArray(value) && value.every((id) => typeof id === 'string'))
27
- details[key] = [...value];
28
- }
29
- if (Object.keys(details).length)
30
- error.details = details;
31
- }
32
- return { ok: false, error };
33
- }
34
- /** Bind portable tools to an already authorized drive; no model or MCP runtime. */
1
+ import { requireInput } from '../errors.js';
2
+ import { createRetriever } from '../retriever/index.js';
3
+ import { createMemoryTools } from './factory.js';
4
+ /** Bind the existing tool catalog; optional orchestration changes only recall execution. */
35
5
  export async function createTools(configuration, options = {}) {
36
- requireInput(object(configuration) && Object.keys(configuration).every(key => ['drive', 'branch', 'writable'].includes(key)), 'Use drive, optional branch and writable to create memory tools.');
37
- requireInput(configuration.writable === undefined || typeof configuration.writable === 'boolean', 'writable must be a boolean.');
38
- const { drive, branch, writable = false } = configuration;
39
- requireInput(drive && typeof drive.describe === 'function' && typeof drive.recall === 'function', 'Provide a MemDrive handle.');
40
- const data = branch === undefined ? drive : drive.at({ branch });
41
- const descriptor = await drive.describe(options);
42
- checkAbort(options);
43
- const definitions = toolDefinitions(descriptor, writable);
44
- const enabled = new Set(definitions.map(tool => tool.name));
45
- return Object.freeze({
46
- get definitions() { return structuredClone(definitions); },
47
- async execute(name, input, requestOptions = {}) {
48
- try {
49
- requireInput(object(requestOptions) && Object.keys(requestOptions).every(key => key === 'signal'), 'Operation options accept only signal.');
50
- checkAbort(requestOptions);
51
- if (!enabled.has(name))
52
- throw new MemDriveError('UNKNOWN_TOOL', 'Unknown or disabled memory tool.');
53
- requireInput(object(input), 'Tool arguments must be an object.');
54
- // Detach inputs before any SDK operation can yield. No coercion or null stripping.
55
- let args;
56
- try {
57
- args = structuredClone(input);
58
- }
59
- catch {
60
- throw new MemDriveError('INVALID_INPUT', 'Tool arguments must be cloneable data.');
61
- }
62
- let value;
63
- switch (name) {
64
- case 'memdrive_recall':
65
- requireInput(Object.keys(args).length === 1 && Array.isArray(args.requests)
66
- && args.requests.length >= 1 && args.requests.length <= 5, 'recall requires requests containing 1 to 5 search requests.');
67
- value = await data.recall({ requests: args.requests }, requestOptions);
68
- break;
69
- case 'memdrive_read':
70
- value = await data.read(args, requestOptions);
71
- break;
72
- case 'memdrive_describe':
73
- requireInput(Object.keys(args).length === 0, 'describe accepts an empty object.');
74
- value = await drive.describe(requestOptions);
75
- break;
76
- case 'memdrive_count_values':
77
- value = await data.countValues(args, requestOptions);
78
- break;
79
- case 'memdrive_list':
80
- value = await data.list(args, requestOptions);
81
- break;
82
- case 'memdrive_remember':
83
- value = await data.remember(args, requestOptions);
84
- break;
85
- case 'memdrive_forget':
86
- await data.forget(args, requestOptions);
87
- value = { acknowledged: true };
88
- break;
89
- }
90
- requireInput(object(value), 'Memory tool returned an invalid result.');
91
- // Preserve settled SDK outcomes, including completed items in a canceled batch.
92
- // SDK outputs are JSON data. Every transport receives the same detached value.
93
- return { ok: true, value: structuredClone(value) };
94
- }
95
- catch (cause) {
96
- return errorResult(cause);
97
- }
98
- },
99
- });
6
+ requireInput(configuration !== null && typeof configuration === 'object' && !Array.isArray(configuration)
7
+ && Object.keys(configuration).every(key => ['drive', 'branch', 'writable', 'retrieval'].includes(key)), 'Use drive, optional branch, writable and retrieval to create memory tools.');
8
+ const retrieval = configuration?.retrieval;
9
+ requireInput(retrieval === undefined || (retrieval !== null && typeof retrieval === 'object' && !Array.isArray(retrieval)
10
+ && Object.keys(retrieval).every(key => ['strategy', 'agent', 'record'].includes(key))), 'Use documented retrieval options.');
11
+ const agent = retrieval?.agent;
12
+ const snapshot = retrieval === undefined ? undefined : { ...retrieval,
13
+ ...(agent && typeof agent === 'object' && !Array.isArray(agent) ? { agent: { ...agent,
14
+ model: typeof agent.model?.createSession === 'function' ? { createSession: agent.model.createSession.bind(agent.model) } : agent.model,
15
+ ...(agent.limits && typeof agent.limits === 'object' && !Array.isArray(agent.limits) ? { limits: { ...agent.limits } } : {}),
16
+ } } : {}),
17
+ };
18
+ const tools = await createMemoryTools(configuration, options, snapshot === undefined ? undefined
19
+ : drive => createRetriever({ ...snapshot, drive }, options));
20
+ return Object.freeze({ get definitions() { return tools.definitions; }, execute: tools.execute });
100
21
  }
101
22
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIjD,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,aAAiC,EAAE,UAA0B,EAAE;IAC7F,YAAY,CAAC,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;WAClG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,4EAA4E,CAAC,CAAC;IAC1L,MAAM,SAAS,GAAG,aAAa,EAAE,SAAS,CAAC;IAC3C,YAAY,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;WAClH,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,mCAAmC,CAAC,CAAC;IACjI,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,CAAC;IAC/B,MAAM,QAAQ,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS;QACjE,GAAG,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK;gBACjF,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,EAAE,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;gBACtI,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/H,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACZ,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;QAC5F,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,WAAW,KAAK,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACtG,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { CreateToolsOptions, MemoryTools } from './types.js';
2
+ /** Internal model-session identities, never public memory-tool arguments or results. */
3
+ export type EvidenceReference = {
4
+ memId: string;
5
+ start: number;
6
+ end: number;
7
+ } | {
8
+ memId: string;
9
+ };
10
+ export interface InternalToolsOptions extends CreateToolsOptions {
11
+ shortIds?: boolean;
12
+ evidenceIds?: boolean;
13
+ }
14
+ export interface InternalMemoryTools extends MemoryTools {
15
+ resolveId(id: string): string;
16
+ resolveEvidence(id: string): EvidenceReference;
17
+ }
18
+ //# sourceMappingURL=internal-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"internal-types.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAClG,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACpD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAClD"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=internal-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"internal-types.js","sourceRoot":"","sources":["../../../src/tools/internal-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,8 @@
1
+ /** One read-only tool registry owns this map; never inspect arbitrary text for IDs. */
2
+ export declare function shortIds(): {
3
+ resolve: (id: unknown) => string;
4
+ query: (value: unknown) => void;
5
+ output: (name: string, value: Record<string, unknown>) => void;
6
+ read: (args: Record<string, unknown>) => void;
7
+ };
8
+ //# sourceMappingURL=short-ids.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"short-ids.d.ts","sourceRoot":"","sources":["../../../src/tools/short-ids.ts"],"names":[],"mappings":"AAIA,uFAAuF;AACvF,wBAAgB,QAAQ;kBAEC,OAAO,KAAG,MAAM;mBA+Bf,OAAO,KAAG,IAAI;mBAKd,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;iBAWrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAGxE"}
@@ -0,0 +1,78 @@
1
+ import { MemDriveError } from '../errors.js';
2
+ const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
3
+ /** One read-only tool registry owns this map; never inspect arbitrary text for IDs. */
4
+ export function shortIds() {
5
+ const canonical = new Map(), aliases = new Map();
6
+ const resolve = (id) => {
7
+ const value = typeof id === 'string' ? canonical.get(id) : undefined;
8
+ if (value === undefined)
9
+ throw new MemDriveError('INVALID_INPUT', 'Use a memory ID returned by this tool session.');
10
+ return value;
11
+ };
12
+ const encode = (id) => {
13
+ if (typeof id !== 'string')
14
+ throw new MemDriveError('INVALID_RESULT', 'Memory tool returned an invalid ID.');
15
+ let alias = aliases.get(id);
16
+ if (alias === undefined) {
17
+ alias = `m${aliases.size + 1}`;
18
+ aliases.set(id, alias);
19
+ canonical.set(alias, id);
20
+ }
21
+ return alias;
22
+ };
23
+ const filter = (root) => {
24
+ const pending = [root], seen = new Set();
25
+ while (pending.length) {
26
+ const value = pending.pop();
27
+ if (!object(value) || seen.has(value))
28
+ continue;
29
+ seen.add(value);
30
+ const keys = Object.keys(value);
31
+ // Leave malformed/cyclic expressions for the SDK's normal validation.
32
+ if (keys.length === 1 && ['and', 'or'].includes(keys[0])) {
33
+ const children = value[keys[0]];
34
+ if (Array.isArray(children))
35
+ for (const child of children)
36
+ pending.push(child);
37
+ }
38
+ else if (keys.length === 3 && keys.every(key => ['field', 'op', 'value'].includes(key)) && value.field === 'id') {
39
+ if (value.op === 'eq' || value.op === 'neq')
40
+ value.value = resolve(value.value);
41
+ else if (value.op === 'in' && Array.isArray(value.value))
42
+ value.value = value.value.map(resolve);
43
+ }
44
+ }
45
+ };
46
+ const query = (value) => {
47
+ if (!object(value))
48
+ return;
49
+ if (Array.isArray(value.excludeIds))
50
+ value.excludeIds = value.excludeIds.map(resolve);
51
+ filter(value.filter);
52
+ };
53
+ const output = (name, value) => {
54
+ if (name === 'memdrive_recall' && Array.isArray(value.results)) {
55
+ for (const item of value.results)
56
+ if (object(item) && Array.isArray(item.matches))
57
+ for (const match of item.matches)
58
+ if (object(match))
59
+ match.memId = encode(match.memId);
60
+ }
61
+ else if ((name === 'memdrive_read' || name === 'memdrive_list') && Array.isArray(value.mems)) {
62
+ for (const mem of value.mems)
63
+ if (object(mem))
64
+ mem.id = encode(mem.id);
65
+ }
66
+ else if (name === 'memdrive_count_values' && object(value.values) && object(value.values.id)
67
+ && Array.isArray(value.values.id.buckets)) {
68
+ for (const bucket of value.values.id.buckets)
69
+ if (object(bucket))
70
+ bucket.value = encode(bucket.value);
71
+ }
72
+ };
73
+ return { resolve, query, output, read: (args) => {
74
+ if (Array.isArray(args.ids))
75
+ args.ids = args.ids.map(resolve);
76
+ } };
77
+ }
78
+ //# sourceMappingURL=short-ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"short-ids.js","sourceRoot":"","sources":["../../../src/tools/short-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE1I,uFAAuF;AACvF,MAAM,UAAU,QAAQ;IACpB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,EAAE,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjF,MAAM,OAAO,GAAG,CAAC,EAAW,EAAU,EAAE;QACpC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,gDAAgD,CAAC,CAAC;QACpH,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAW,EAAU,EAAE;QACnC,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,qCAAqC,CAAC,CAAC;QAC7G,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAa,EAAQ,EAAE;QACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QACjD,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAChD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,sEAAsE;YACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;gBACjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAAE,KAAK,MAAM,KAAK,IAAI,QAAQ;wBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnF,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChH,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK;oBAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;qBAC3E,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;oBAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrG,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAc,EAAQ,EAAE;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;YAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAA8B,EAAQ,EAAE;QAClE,IAAI,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO;gBAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;oBAC7E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO;wBAAE,IAAI,MAAM,CAAC,KAAK,CAAC;4BAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/F,CAAC;aAAM,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,eAAe,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7F,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,MAAM,CAAC,GAAG,CAAC;oBAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,IAAI,KAAK,uBAAuB,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;eACvF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO;gBAAE,IAAI,MAAM,CAAC,MAAM,CAAC;oBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1G,CAAC;IACL,CAAC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAA6B,EAAE,EAAE;YACrE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC,EAAE,CAAC;AACR,CAAC"}
@@ -1,4 +1,5 @@
1
1
  import type { MemDrive, RequestOptions } from '../types.js';
2
+ import type { CreateRetrieverOptions } from '../retriever/types.js';
2
3
  /** Portable JSON Schema; transport adapters may rename the containing field. */
3
4
  export type JsonSchema = Record<string, unknown>;
4
5
  export type ToolName = 'memdrive_recall' | 'memdrive_read' | 'memdrive_describe' | 'memdrive_count_values' | 'memdrive_list' | 'memdrive_remember' | 'memdrive_forget';
@@ -37,6 +38,8 @@ export type ToolResult = {
37
38
  };
38
39
  export interface CreateToolsOptions {
39
40
  drive: MemDrive;
41
+ /** Configure only recall orchestration; tool inventory and batch input stay unchanged. */
42
+ retrieval?: Omit<CreateRetrieverOptions, 'drive'>;
40
43
  /** Omit to use the supplied handle's branch. Model arguments cannot change it. */
41
44
  branch?: string;
42
45
  /** Include remember and forget. Defaults to false. This is not authorization. */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,eAAe,GAAG,mBAAmB,GAC1E,uBAAuB,GAAG,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAC1F,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CAC1B;AACD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,UAAU,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;CAChC;AACD,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACL;AACD,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AACxG,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,QAAQ,CAAC;IAChB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,WAAW;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvF"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,eAAe,GAAG,mBAAmB,GAC1E,uBAAuB,GAAG,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAC1F,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CAC1B;AACD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,UAAU,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;CAChC;AACD,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACL;AACD,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AACxG,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,QAAQ,CAAC;IAChB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAClD,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,WAAW;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvF"}