dsh-mnemon-provider-hindsight 0.5.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-external contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,9 @@
1
+ # dsh-mnemon-provider-hindsight
2
+
3
+ Knowledge-graph memory with entity resolution, observations, multi-strategy recall, and reflection.
4
+
5
+ This is a Memory Spaces **child module**, not a top-level Mnemon contribution. Its manifest, descriptor, driver, build and tests live here. It uses only the public dsh-mnemon-source-memory-spaces/provider-sdk entry.
6
+
7
+ Install alongside the Memory Spaces Source, then list { use: 'dsh-mnemon-provider-hindsight', instanceId: 'hindsight' } in that Source's providers. Multiple Source instances own independent children. Connection settings remain Source-owned; secret fields are never projected to the LLM.
8
+
9
+ Run pnpm install && pnpm verify from this directory. No root test config or private controller is required.
@@ -0,0 +1,84 @@
1
+ //#endregion
2
+ //#region src/descriptor.ts
3
+ /** Browser-safe metadata owned by this Provider. */
4
+ const descriptor = {
5
+ "id": "hindsight",
6
+ "label": "Hindsight",
7
+ "icon": {
8
+ "kind": "data-url",
9
+ "value": "data:image/png;base64,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"
10
+ },
11
+ "kind": "remote",
12
+ "workspaceBinding": "provider-global",
13
+ "summary": "Knowledge-graph memory with entity resolution, observations, multi-strategy recall, and reflection.",
14
+ "summaryI18nKey": "overview.providerSummary.hindsight",
15
+ "origin": "third-party",
16
+ "capabilities": {
17
+ "search": true,
18
+ "browse": true,
19
+ "graph": true,
20
+ "entities": true,
21
+ "related": true,
22
+ "remember": true,
23
+ "link": false,
24
+ "forget": true,
25
+ "writeMode": "async-extracting",
26
+ "deletionMode": "soft"
27
+ },
28
+ "fields": [
29
+ {
30
+ "key": "endpoint",
31
+ "label": "Endpoint",
32
+ "scope": "service",
33
+ "input": "url",
34
+ "required": true,
35
+ "defaultValue": "https://api.hindsight.vectorize.io",
36
+ "i18nKey": "overview.providerEndpoint"
37
+ },
38
+ {
39
+ "key": "apiKey",
40
+ "label": "API key",
41
+ "scope": "service",
42
+ "input": "secret",
43
+ "required": false,
44
+ "i18nKey": "overview.providerApiKey"
45
+ },
46
+ {
47
+ "key": "bankId",
48
+ "label": "Memory bank",
49
+ "scope": "memory",
50
+ "input": "text",
51
+ "required": true,
52
+ "defaultValue": "dsh",
53
+ "i18nKey": "overview.providerField.bankId"
54
+ },
55
+ {
56
+ "key": "budget",
57
+ "label": "Recall budget",
58
+ "scope": "memory",
59
+ "input": "select",
60
+ "required": true,
61
+ "defaultValue": "mid",
62
+ "options": [
63
+ {
64
+ "value": "low",
65
+ "label": "Low",
66
+ "i18nKey": "overview.providerOption.low"
67
+ },
68
+ {
69
+ "value": "mid",
70
+ "label": "Medium",
71
+ "i18nKey": "overview.providerOption.mid"
72
+ },
73
+ {
74
+ "value": "high",
75
+ "label": "High",
76
+ "i18nKey": "overview.providerOption.high"
77
+ }
78
+ ],
79
+ "i18nKey": "overview.providerField.budget"
80
+ }
81
+ ]
82
+ };
83
+ //#endregion
84
+ export { descriptor as t };
@@ -0,0 +1,6 @@
1
+ import { MemoryProviderDescriptor } from "dsh-mnemon-source-memory-spaces/provider-sdk";
2
+ //#region src/descriptor.d.ts
3
+ /** Browser-safe metadata owned by this Provider. */
4
+ declare const descriptor: MemoryProviderDescriptor;
5
+ //#endregion
6
+ export { descriptor };
@@ -0,0 +1,2 @@
1
+ import { t as descriptor } from "./descriptor-BxGaZkfv.js";
2
+ export { descriptor };
package/lib/index.d.ts ADDED
@@ -0,0 +1,24 @@
1
+ import { descriptor } from "./descriptor.js";
2
+ import { EdgeType, HttpMemoryProvider, HttpProviderOptions, Insight, JsonValue, MemoryBody, MemoryGraphSnapshot, MemoryListRequest, MemoryProviderAdapter, MemorySpaceAuthority, ProviderBodyStatus, ProviderMemorySpace, ProviderSearchResult, RememberRequest, SearchRequest } from "dsh-mnemon-source-memory-spaces/provider-sdk";
3
+ //#region src/driver.d.ts
4
+ declare class HindsightProvider extends HttpMemoryProvider implements MemoryProviderAdapter {
5
+ readonly id: "hindsight";
6
+ readonly scoreSemantics: import("dsh-mnemon-source-memory-spaces/provider-sdk").ProviderScoreSemantics;
7
+ constructor(memoryBodies: MemorySpaceAuthority, options?: HttpProviderOptions);
8
+ discover(connection: Record<string, string | number | boolean>, signal?: AbortSignal): Promise<ProviderMemorySpace[]>;
9
+ status(body: MemoryBody, signal?: AbortSignal): Promise<ProviderBodyStatus>;
10
+ search(body: MemoryBody, request: SearchRequest, signal?: AbortSignal): Promise<ProviderSearchResult>;
11
+ list(body: MemoryBody, request: MemoryListRequest, signal?: AbortSignal): Promise<Insight[]>;
12
+ graph(body: MemoryBody, signal?: AbortSignal): Promise<MemoryGraphSnapshot>;
13
+ related(body: MemoryBody, id: string, depth: number, _edge?: EdgeType, signal?: AbortSignal): Promise<Insight[]>;
14
+ remember(body: MemoryBody, request: RememberRequest, signal?: AbortSignal): Promise<JsonValue>;
15
+ forget(body: MemoryBody, id: string, signal?: AbortSignal): Promise<JsonValue>;
16
+ private bankPath;
17
+ private headers;
18
+ }
19
+ //#endregion
20
+ //#region src/index.d.ts
21
+ declare const definition: import("dsh-mnemon-source-memory-spaces/provider-sdk").MemorySpaceProviderDefinition;
22
+ declare const _default: import("dsh-mnemon-source-memory-spaces/provider-sdk").MemorySpaceProviderModule<undefined>;
23
+ //#endregion
24
+ export { HindsightProvider, _default as default, definition, descriptor };
package/lib/index.js ADDED
@@ -0,0 +1,277 @@
1
+ import { t as descriptor } from "./descriptor-BxGaZkfv.js";
2
+ import { HttpMemoryProvider, MEMORY_SPACE_PROVIDER_API_VERSION, NORMALIZED_RELEVANCE_SCORE, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString } from "dsh-mnemon-source-memory-spaces/provider-sdk";
3
+ import { randomUUID } from "node:crypto";
4
+ //#region src/driver.ts
5
+ function insight(value) {
6
+ const item = jsonObject(value);
7
+ const id = jsonString(item?.id);
8
+ const content = jsonString(item?.text) ?? jsonString(item?.content) ?? jsonString(item?.label);
9
+ if (id === void 0 || content === void 0) return void 0;
10
+ const scores = jsonObject(item?.scores);
11
+ const score = jsonNumber(scores?.final) ?? jsonNumber(item?.score);
12
+ const createdAt = jsonString(item?.mentioned_at) ?? jsonString(item?.date) ?? jsonString(item?.occurred_start);
13
+ const rawEntities = item?.entities;
14
+ const entities = Array.isArray(rawEntities) ? rawEntities.filter((entry) => typeof entry === "string") : typeof rawEntities === "string" ? rawEntities.split(",").map((entry) => entry.replace(/\s*\([^)]*\)\s*$/u, "").trim()).filter(Boolean) : [];
15
+ const tags = jsonArray(item?.tags).filter((entry) => typeof entry === "string");
16
+ return {
17
+ id,
18
+ content,
19
+ category: jsonString(item?.type) ?? jsonString(item?.fact_type) ?? "general",
20
+ source: "external",
21
+ ...score === void 0 ? {} : { score },
22
+ ...createdAt === void 0 ? {} : { createdAt },
23
+ ...entities.length === 0 ? {} : { entities },
24
+ ...tags.length === 0 ? {} : { tags }
25
+ };
26
+ }
27
+ function edgeType(value) {
28
+ return value === "temporal" || value === "semantic" || value === "causal" || value === "entity" ? value : void 0;
29
+ }
30
+ var HindsightProvider = class extends HttpMemoryProvider {
31
+ id = "hindsight";
32
+ scoreSemantics = NORMALIZED_RELEVANCE_SCORE;
33
+ constructor(memoryBodies, options = {}) {
34
+ super(memoryBodies, {
35
+ label: descriptor.label,
36
+ ...options
37
+ });
38
+ }
39
+ async discover(connection, signal) {
40
+ const payload = await this.requestConnection(connection, "/v1/default/banks", {
41
+ headers: this.headers(connection),
42
+ signal
43
+ });
44
+ return firstArray(payload, "banks", "items").flatMap((value) => {
45
+ const item = jsonObject(value);
46
+ const id = jsonString(item?.bank_id) ?? jsonString(item?.id);
47
+ if (id === void 0) return [];
48
+ const description = jsonString(item?.mission)?.trim() || jsonString(item?.description)?.trim() || `Hindsight memory bank ${id}`;
49
+ return [{
50
+ externalId: id,
51
+ name: jsonString(item?.name) ?? id,
52
+ description,
53
+ connection: {
54
+ bankId: id,
55
+ budget: "mid"
56
+ }
57
+ }];
58
+ });
59
+ }
60
+ async status(body, signal) {
61
+ try {
62
+ const connection = this.connection(body);
63
+ await this.request(body, "/health/live", {
64
+ headers: this.headers(connection),
65
+ signal
66
+ });
67
+ try {
68
+ const [statsPayload, entitiesPayload] = await Promise.all([this.request(body, `${this.bankPath(connection)}/stats`, {
69
+ headers: this.headers(connection),
70
+ signal
71
+ }), this.request(body, `${this.bankPath(connection)}/entities?limit=100&offset=0`, {
72
+ headers: this.headers(connection),
73
+ signal
74
+ })]);
75
+ const stats = jsonObject(statsPayload) ?? {};
76
+ const byFactType = jsonObject(stats.nodes_by_fact_type) ?? {};
77
+ const byCategory = Object.fromEntries(Object.entries(byFactType).flatMap(([category, count]) => {
78
+ const value = jsonNumber(count);
79
+ return value === void 0 ? [] : [[category, value]];
80
+ }));
81
+ const operations = jsonObject(stats.operations_by_status) ?? {};
82
+ const topEntities = firstArray(entitiesPayload, "items").flatMap((value) => {
83
+ const item = jsonObject(value);
84
+ const entity = jsonString(item?.canonical_name);
85
+ const count = jsonNumber(item?.mention_count);
86
+ return entity === void 0 || count === void 0 ? [] : [{
87
+ entity,
88
+ count
89
+ }];
90
+ });
91
+ return {
92
+ healthy: true,
93
+ stats: {
94
+ totalInsights: jsonNumber(stats.total_nodes) ?? 0,
95
+ deletedInsights: 0,
96
+ edgeCount: jsonNumber(stats.total_links) ?? 0,
97
+ oplogCount: Object.values(operations).reduce((total, value) => total + (jsonNumber(value) ?? 0), 0),
98
+ dbSizeBytes: 0,
99
+ byCategory,
100
+ topEntities
101
+ }
102
+ };
103
+ } catch {
104
+ return { healthy: true };
105
+ }
106
+ } catch (error) {
107
+ return {
108
+ healthy: false,
109
+ error: error instanceof Error ? error.message : String(error)
110
+ };
111
+ }
112
+ }
113
+ async search(body, request, signal) {
114
+ const connection = this.connection(body);
115
+ const payload = await this.request(body, `${this.bankPath(connection)}/memories/recall`, {
116
+ headers: this.headers(connection),
117
+ json: {
118
+ query: request.query,
119
+ budget: String(connection.budget ?? "mid"),
120
+ max_tokens: Math.min(Math.max((request.limit ?? 10) * 400, 400), 8e3),
121
+ types: [
122
+ "world",
123
+ "experience",
124
+ "observation"
125
+ ],
126
+ prefer_observations: true
127
+ },
128
+ signal
129
+ });
130
+ return { results: firstArray(payload, "results", "items").map(insight).filter((item) => item !== void 0).slice(0, request.limit ?? 10) };
131
+ }
132
+ async list(body, request, signal) {
133
+ const connection = this.connection(body);
134
+ const params = new URLSearchParams({
135
+ limit: String(Math.min(Math.max(request.limit ?? 200, 1), 1e3)),
136
+ offset: "0",
137
+ state: "valid"
138
+ });
139
+ if (request.query !== void 0 && request.query.trim() !== "") params.set("q", request.query.trim());
140
+ const payload = await this.request(body, `${this.bankPath(connection)}/memories/list?${params}`, {
141
+ headers: this.headers(connection),
142
+ signal
143
+ });
144
+ return firstArray(payload, "items", "results").map(insight).filter((item) => item !== void 0).filter((item) => request.category === void 0 || item.category === request.category);
145
+ }
146
+ async graph(body, signal) {
147
+ const connection = this.connection(body);
148
+ const payload = jsonObject(await this.request(body, `${this.bankPath(connection)}/graph?limit=1000`, {
149
+ headers: this.headers(connection),
150
+ signal
151
+ })) ?? {};
152
+ return {
153
+ nodes: jsonArray(payload.nodes).flatMap((value) => {
154
+ const item = jsonObject(value);
155
+ const data = jsonObject(item?.data) ?? item;
156
+ const projected = insight(data);
157
+ return projected === void 0 ? [] : [{
158
+ ...projected,
159
+ color: jsonString(data?.color) ?? "#6574d9"
160
+ }];
161
+ }),
162
+ edges: jsonArray(payload.edges).flatMap((value) => {
163
+ const item = jsonObject(value);
164
+ const data = jsonObject(item?.data) ?? item;
165
+ const sourceId = jsonString(data?.from) ?? jsonString(data?.source);
166
+ const targetId = jsonString(data?.to) ?? jsonString(data?.target);
167
+ if (sourceId === void 0 || targetId === void 0) return [];
168
+ const rawType = jsonString(data?.type) ?? jsonString(data?.linkType);
169
+ const type = edgeType(rawType);
170
+ return [{
171
+ sourceId,
172
+ targetId,
173
+ label: rawType ?? "related",
174
+ color: type === "causal" ? "#e74c3c" : type === "entity" ? "#2ecc71" : type === "temporal" ? "#aaaaaa" : "#3498db",
175
+ ...type === void 0 ? {} : { type }
176
+ }];
177
+ }),
178
+ generatedAt: (/* @__PURE__ */ new Date()).toISOString()
179
+ };
180
+ }
181
+ async related(body, id, depth, _edge, signal) {
182
+ const graph = await this.graph(body, signal);
183
+ let frontier = /* @__PURE__ */ new Set([id]);
184
+ const visited = /* @__PURE__ */ new Set([id]);
185
+ for (let level = 0; level < depth; level += 1) {
186
+ const next = /* @__PURE__ */ new Set();
187
+ for (const edge of graph.edges) {
188
+ if (frontier.has(edge.sourceId) && !visited.has(edge.targetId)) next.add(edge.targetId);
189
+ if (frontier.has(edge.targetId) && !visited.has(edge.sourceId)) next.add(edge.sourceId);
190
+ }
191
+ for (const value of next) visited.add(value);
192
+ frontier = next;
193
+ }
194
+ return graph.nodes.filter((node) => node.id !== id && visited.has(node.id)).map(({ color: _color, ...node }) => node);
195
+ }
196
+ async remember(body, request, signal) {
197
+ const connection = this.connection(body);
198
+ const operationId = randomUUID();
199
+ const payload = jsonObject(await this.request(body, `${this.bankPath(connection)}/memories`, {
200
+ headers: this.headers(connection),
201
+ json: {
202
+ items: [{
203
+ content: request.content,
204
+ context: request.category ?? "dsh-mnemon",
205
+ metadata: { source: "dsh-mnemon" },
206
+ ...request.tags === void 0 ? {} : { tags: request.tags },
207
+ ...request.entities === void 0 ? {} : { entities: request.entities.map((text) => ({ text })) }
208
+ }],
209
+ async: true,
210
+ operation_id: operationId
211
+ },
212
+ signal
213
+ })) ?? {};
214
+ return {
215
+ action: "queued",
216
+ provider: this.id,
217
+ summary: "Hindsight queued the content for structured memory extraction.",
218
+ operationId: jsonString(payload.operation_id) ?? operationId,
219
+ ...jsonNumber(payload.items_count) === void 0 ? {} : { itemsCount: jsonNumber(payload.items_count) }
220
+ };
221
+ }
222
+ async forget(body, id, signal) {
223
+ const connection = this.connection(body);
224
+ await this.request(body, `${this.bankPath(connection)}/memories/${encodeURIComponent(id)}`, {
225
+ method: "PATCH",
226
+ headers: this.headers(connection),
227
+ json: {
228
+ state: "invalidated",
229
+ reason: "Forgotten from dsh-mnemon"
230
+ },
231
+ signal
232
+ });
233
+ return {
234
+ action: "invalidated",
235
+ provider: this.id,
236
+ id
237
+ };
238
+ }
239
+ bankPath(connection) {
240
+ return `/v1/default/banks/${encodeURIComponent(String(connection.bankId))}`;
241
+ }
242
+ headers(connection) {
243
+ const token = String(connection.apiKey ?? "").replace(/^Bearer\s+/iu, "");
244
+ return token === "" ? {} : { Authorization: `Bearer ${token}` };
245
+ }
246
+ };
247
+ //#endregion
248
+ //#region src/index.ts
249
+ const definition = defineMemorySpaceProviderDefinition({
250
+ manifest: {
251
+ apiVersion: MEMORY_SPACE_PROVIDER_API_VERSION,
252
+ kind: "provider",
253
+ typeId: descriptor.id,
254
+ packageName: "dsh-mnemon-provider-hindsight",
255
+ version: "0.5.0-rc.1",
256
+ label: descriptor.label,
257
+ icon: descriptor.icon,
258
+ summary: descriptor.summary,
259
+ ...descriptor.summaryI18nKey === void 0 ? {} : { summaryI18nKey: descriptor.summaryI18nKey },
260
+ origin: descriptor.origin,
261
+ locality: descriptor.kind,
262
+ workspaceBinding: descriptor.workspaceBinding,
263
+ capabilities: descriptor.capabilities,
264
+ fields: descriptor.fields,
265
+ secrets: descriptor.fields.filter((field) => field.input === "secret").map((field) => field.key),
266
+ scoreSemantics: "normalized-relevance"
267
+ },
268
+ create: (context) => new HindsightProvider(context.memoryBodies, { requestTimeoutMs: context.config.timeoutMs })
269
+ });
270
+ var src_default = defineMemorySpaceProvider({
271
+ id: descriptor.id,
272
+ apply(ctx, host) {
273
+ host.install(ctx, definition);
274
+ }
275
+ });
276
+ //#endregion
277
+ export { HindsightProvider, src_default as default, definition, descriptor };
package/package.json ADDED
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "dsh-mnemon-provider-hindsight",
3
+ "version": "0.5.0-rc.1",
4
+ "description": "Hindsight Provider child for the Memory Spaces Source.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "engines": {
8
+ "node": ">=20"
9
+ },
10
+ "exports": {
11
+ ".": {
12
+ "types": "./lib/index.d.ts",
13
+ "default": "./lib/index.js"
14
+ },
15
+ "./descriptor": {
16
+ "types": "./lib/descriptor.d.ts",
17
+ "default": "./lib/descriptor.js"
18
+ },
19
+ "./package.json": "./package.json"
20
+ },
21
+ "files": [
22
+ "lib",
23
+ "README.md"
24
+ ],
25
+ "scripts": {
26
+ "typecheck": "tsc --noEmit",
27
+ "build": "tsdown",
28
+ "test": "vitest run",
29
+ "verify": "pnpm typecheck && pnpm test && pnpm build"
30
+ },
31
+ "peerDependencies": {
32
+ "@deepseek-ai/cordis": "^4.0.1",
33
+ "dsh-mnemon-source-memory-spaces": "0.5.0-rc.1"
34
+ },
35
+ "devDependencies": {
36
+ "@types/node": "^22.0.0",
37
+ "dsh-mnemon-source-memory-spaces": "0.5.0-rc.1",
38
+ "tsdown": "^0.22.0",
39
+ "typescript": "^5.9.0",
40
+ "vitest": "^3.2.0"
41
+ },
42
+ "publishConfig": {
43
+ "access": "public",
44
+ "tag": "rc"
45
+ },
46
+ "repository": {
47
+ "type": "git",
48
+ "url": "git+https://github.com/omdsh-dev/dsh-mnemon.git",
49
+ "directory": "plugins/dsh-mnemon-provider-hindsight"
50
+ },
51
+ "homepage": "https://github.com/omdsh-dev/dsh-mnemon/tree/main/plugins/dsh-mnemon-provider-hindsight#readme",
52
+ "bugs": {
53
+ "url": "https://github.com/omdsh-dev/dsh-mnemon/issues"
54
+ }
55
+ }