dsh-mnemon-provider-hindsight 0.5.2 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,9 +1,27 @@
1
1
  # dsh-mnemon-provider-hindsight
2
2
 
3
- Knowledge-graph memory with entity resolution, observations, multi-strategy recall, and reflection.
3
+ An adapter for Hindsight banks, entities, relationships and retained evidence.
4
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.
5
+ Requires a Hindsight endpoint and bank scope. Statistics availability depends on the upstream deployment.
6
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.
7
+ ## Use
8
8
 
9
- Run pnpm install && pnpm verify from this directory. No root test config or private controller is required.
9
+ The default `dsh-mnemon` Starter already installs this package. Enable and configure the service in **Settings → Memory System**, then inspect its synchronized Memory Spaces.
10
+
11
+ For a custom composition, install this package alongside `dsh-mnemon-source-memory-spaces` and include it in that Source's `config.providers`:
12
+
13
+ ```yaml
14
+ providers:
15
+ - use: dsh-mnemon-provider-hindsight
16
+ instanceId: hindsight
17
+ ```
18
+
19
+ This is a **Memory Spaces child module**, not a top-level Source or a complete Strategy. It registers through `dsh-mnemon-source-memory-spaces/provider-sdk`; each parent Source owns its child Fibers, connection settings and lifetime. Credentials stay on the Host.
20
+
21
+ [Provider setup and capability matrix](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/memory-providers.md) · [中文指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/memory-providers.md)
22
+
23
+ ## Develop independently
24
+
25
+ From a source checkout with the declared dependencies installed, run `pnpm verify`. Tests, build and public exports belong to this package, without importing another package's controllers or repository configuration. Use the Source's public `/testing` fixtures for child registration and driver conformance; live service tests require a separately authorized environment.
26
+
27
+ [Plugin author guide](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md)
package/lib/index.d.ts CHANGED
@@ -4,7 +4,7 @@ import { EdgeType, HttpMemoryProvider, HttpProviderOptions, Insight, JsonValue,
4
4
  declare class HindsightProvider extends HttpMemoryProvider implements MemoryProviderAdapter {
5
5
  readonly id: "hindsight";
6
6
  readonly scoreSemantics: import("dsh-mnemon-source-memory-spaces/provider-sdk").ProviderScoreSemantics;
7
- constructor(memoryBodies: MemorySpaceAuthority, options?: HttpProviderOptions);
7
+ constructor(memorySpaces: MemorySpaceAuthority, options?: HttpProviderOptions);
8
8
  discover(connection: Record<string, string | number | boolean>, signal?: AbortSignal): Promise<ProviderMemorySpace[]>;
9
9
  status(body: MemoryBody, signal?: AbortSignal): Promise<ProviderBodyStatus>;
10
10
  search(body: MemoryBody, request: SearchRequest, signal?: AbortSignal): Promise<ProviderSearchResult>;
package/lib/index.js CHANGED
@@ -30,8 +30,8 @@ function edgeType(value) {
30
30
  var HindsightProvider = class extends HttpMemoryProvider {
31
31
  id = "hindsight";
32
32
  scoreSemantics = NORMALIZED_RELEVANCE_SCORE;
33
- constructor(memoryBodies, options = {}) {
34
- super(memoryBodies, {
33
+ constructor(memorySpaces, options = {}) {
34
+ super(memorySpaces, {
35
35
  label: descriptor.label,
36
36
  ...options
37
37
  });
@@ -252,7 +252,7 @@ const definition = defineMemorySpaceProviderDefinition({
252
252
  kind: "provider",
253
253
  typeId: descriptor.id,
254
254
  packageName: "dsh-mnemon-provider-hindsight",
255
- version: "0.5.2",
255
+ version: "0.5.4",
256
256
  label: descriptor.label,
257
257
  icon: descriptor.icon,
258
258
  summary: descriptor.summary,
@@ -265,7 +265,7 @@ const definition = defineMemorySpaceProviderDefinition({
265
265
  secrets: descriptor.fields.filter((field) => field.input === "secret").map((field) => field.key),
266
266
  scoreSemantics: "normalized-relevance"
267
267
  },
268
- create: (context) => new HindsightProvider(context.memoryBodies, { requestTimeoutMs: context.config.timeoutMs })
268
+ create: (context) => new HindsightProvider(context.memorySpaces ?? context.memoryBodies, { requestTimeoutMs: context.config.timeoutMs })
269
269
  });
270
270
  var src_default = defineMemorySpaceProvider({
271
271
  id: descriptor.id,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-mnemon-provider-hindsight",
3
- "version": "0.5.2",
3
+ "version": "0.5.4",
4
4
  "description": "Hindsight Provider child for the Memory Spaces Source.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -34,7 +34,7 @@
34
34
  },
35
35
  "devDependencies": {
36
36
  "@types/node": "^22.0.0",
37
- "dsh-mnemon-source-memory-spaces": "^0.5.2",
37
+ "dsh-mnemon-source-memory-spaces": "^0.5.4",
38
38
  "tsdown": "^0.22.0",
39
39
  "typescript": "^5.9.0",
40
40
  "vitest": "^3.2.0"