hippo-memory 1.41.0 → 1.42.0

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/dist/cli.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA2BH,OAAO,EAWL,WAAW,EAEZ,MAAM,aAAa,CAAC;AA6HrB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AA4ChC,kFAAkF;AAClF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAsJD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;CAAE,CAwCjI;AAqxED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,CAyF3F;AAyGD;;;GAGG;AACH,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAuD/D;AAigHD,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,EACtF,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CA8BN"}
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA2BH,OAAO,EAWL,WAAW,EAEZ,MAAM,aAAa,CAAC;AA6HrB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AA4ChC,kFAAkF;AAClF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAuJD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;CAAE,CAwCjI;AAqxED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,CAyF3F;AAyGD;;;GAGG;AACH,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAuD/D;AAigHD,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,EACtF,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CA8BN"}
package/dist/cli.js CHANGED
@@ -117,6 +117,7 @@ import { multihopSearch } from './multihop.js';
117
117
  import { graphExpandRecall, MAX_HOPS, DEFAULT_MAX_NEIGHBORS } from './graph-recall.js';
118
118
  import { DEFAULT_GRAPH_STREAM_WEIGHT } from './graph-stream.js';
119
119
  import { getReranker } from './rerankers/index.js';
120
+ import { JEV_DEFAULT_TOP_K } from './rerankers/jev.js';
120
121
  import { computeSalience } from './salience.js';
121
122
  import { renderAmbientSummary } from './ambient.js';
122
123
  import { validateOwner, isStrictOwnerEnv } from './owner-validation.js';
@@ -1213,10 +1214,10 @@ async function cmdRecall(hippoRoot, query, flags) {
1213
1214
  // --reranker <name> is set, look up the reranker fn from the registry
1214
1215
  // (src/rerankers/index.ts) and apply it to the top-K candidates. The
1215
1216
  // reranker reorders (and may rescale) results; the post-budget set is
1216
- // returned. Default off; opt-in via --reranker <cross-encoder|llm>. The
1217
+ // returned. Default off; opt-in via --reranker <cross-encoder|jev|llm>. The
1217
1218
  // structurally similar --rerank-utility block above is the OFC MVP and is
1218
1219
  // independent — both can run in the same recall, with --rerank-utility
1219
- // applied first. Available rerankers: cross-encoder, llm (see
1220
+ // applied first. Available rerankers: cross-encoder, jev, llm (see
1220
1221
  // src/rerankers/index.ts). The Track 1 `features` reranker was removed in
1221
1222
  // v1.9.1 per the F10 HARD RETRACTION; it is no longer a valid value.
1222
1223
  const rerankerName = flags['reranker'] !== undefined ? String(flags['reranker']).trim() : '';
@@ -1225,7 +1226,7 @@ async function cmdRecall(hippoRoot, query, flags) {
1225
1226
  if (rerankerFn) {
1226
1227
  const topK = flags['reranker-top-k'] !== undefined
1227
1228
  ? parseInt(String(flags['reranker-top-k']), 10)
1228
- : 50;
1229
+ : rerankerName === 'jev' ? JEV_DEFAULT_TOP_K : 50;
1229
1230
  const head = results.slice(0, topK);
1230
1231
  const tail = results.slice(topK);
1231
1232
  const rerankInput = head.map((r, i) => ({ ...r, preRerankRank: i + 1 }));
@@ -8114,11 +8115,17 @@ Commands:
8114
8115
  where cost_factor = min(0.3, tokens / 10000). Re-sorts
8115
8116
  results by utility. Default off. RESEARCH.md §PFC.OFC.
8116
8117
  --reranker <name> Apply a reranker pass after retrieval
8117
- (cross-encoder|llm). Looks up the named
8118
+ (cross-encoder|jev|llm). Looks up the named
8118
8119
  reranker from src/rerankers/index.ts and re-orders
8119
8120
  the top-K candidates. Default unset (no reranker).
8120
- See docs/plans/2026-05-10-f6-reranker-hardening.md.
8121
- --reranker-top-k <n> Cap candidates passed to the reranker (default 50).
8121
+ jev calls the hosted TypeSafe Jev API: it needs
8122
+ TYPESAFE_API_KEY, sends the query and candidate
8123
+ text to that API, costs about 0.0004 USD a recall,
8124
+ and falls back to cross-encoder on any failure.
8125
+ See docs/evals/2026-09-19-jev-reranker.md and
8126
+ docs/plans/2026-05-10-f6-reranker-hardening.md.
8127
+ --reranker-top-k <n> Cap candidates passed to the reranker (default 50;
8128
+ 40 for jev).
8122
8129
  --goal <tag> dlPFC goal-conditioned recall: memories tagged with
8123
8130
  the goal tag get a 1.5x score boost and results are
8124
8131
  re-sorted. Default off. RESEARCH.md §PFC.dlPFC.