@remnic/core 9.3.579 → 9.3.581

package/dist/access-cli.js

@@ -1,6 +1,6 @@
 import {
   Orchestrator
-} from "./chunk-IOTTZLFF.js";
+} from "./chunk-7ZGA7YTS.js";
 import "./chunk-5RIRL3XL.js";
 import "./chunk-KVEVLBKC.js";
 import "./chunk-BFBF3XEF.js";
@@ -34,7 +34,7 @@ import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-452WDNFO.js";
-import "./chunk-TDKQGLJW.js";
+import "./chunk-E3VODCC3.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
 import "./chunk-2IT7WFYE.js";

package/dist/{chunk-IOTTZLFF.js → chunk-7ZGA7YTS.js}

@@ -95,7 +95,7 @@ import {
 import {
   RerankCache,
   rerankLocalOrNoop
-} from "./chunk-TDKQGLJW.js";
+} from "./chunk-E3VODCC3.js";
 import {
   reorderRecallResultsWithMmr
 } from "./chunk-YDBIWGNI.js";
@@ -12405,4 +12405,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-IOTTZLFF.js.map
+//# sourceMappingURL=chunk-7ZGA7YTS.js.map

package/dist/{chunk-TDKQGLJW.js → chunk-E3VODCC3.js}

@@ -47,7 +47,7 @@ function parseRerankResponse(raw, candidates) {
   });
 }
 function stableKey(query, ids) {
-  return `${query.trim().toLowerCase()}|${ids.join(",")}`;
+  return JSON.stringify([query.trim().toLowerCase(), ids]);
 }
 function clampSnippet(snippet, maxChars) {
   const s = snippet.replace(/\s+/g, " ").trim();
@@ -114,4 +114,4 @@ export {
   parseRerankResponse,
   rerankLocalOrNoop
 };
-//# sourceMappingURL=chunk-TDKQGLJW.js.map
+//# sourceMappingURL=chunk-E3VODCC3.js.map

package/dist/chunk-E3VODCC3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rerank.ts"],"sourcesContent":["export interface RerankCandidate {\n  id: string;\n  originalIndex: number;\n}\n\nexport interface RerankScore {\n  id: string;\n  score: number;\n}\n\nexport interface RerankCacheEntry {\n  expiresAtMs: number;\n  rankedIds: string[];\n}\n\nexport class RerankCache {\n  private entries = new Map<string, RerankCacheEntry>();\n\n  get(key: string): string[] | null {\n    const e = this.entries.get(key);\n    if (!e) return null;\n    if (Date.now() > e.expiresAtMs) {\n      this.entries.delete(key);\n      return null;\n    }\n    return e.rankedIds.slice();\n  }\n\n  set(key: string, rankedIds: string[], ttlMs: number): void {\n    this.entries.set(key, { rankedIds: rankedIds.slice(), expiresAtMs: Date.now() + ttlMs });\n  }\n}\n\n/**\n * Parse a rerank response (JSON) and return candidates sorted by score.\n *\n * Rules:\n * - Unknown IDs in the response are ignored.\n * - Candidates missing from the response keep relative order after scored ones.\n * - Stable tie-breaker: originalIndex ascending.\n */\nexport function parseRerankResponse(\n  raw: string,\n  candidates: RerankCandidate[]\n): Array<RerankCandidate & { score?: number }> {\n  const byId = new Map<string, RerankCandidate>();\n  for (const c of candidates) byId.set(c.id, c);\n\n  const scores = new Map<string, number>();\n  try {\n    const parsed = JSON.parse(raw) as { scores?: Array<Partial<RerankScore>> };\n    if (Array.isArray(parsed.scores)) {\n      for (const s of parsed.scores) {\n        if (!s || typeof s.id !== \"string\") continue;\n        if (!byId.has(s.id)) continue;\n        if (typeof s.score !== \"number\" || !Number.isFinite(s.score)) continue;\n        scores.set(s.id, s.score);\n      }\n    }\n  } catch {\n    // Ignore parse errors and fall back to original order.\n  }\n\n  const withScore = candidates.map((c) => ({\n    ...c,\n    score: scores.get(c.id),\n  }));\n\n  return withScore.sort((a, b) => {\n    const as = a.score;\n    const bs = b.score;\n    if (typeof as === \"number\" && typeof bs === \"number\") {\n      if (bs !== as) return bs - as;\n      return a.originalIndex - b.originalIndex;\n    }\n    if (typeof as === \"number\") return -1;\n    if (typeof bs === \"number\") return 1;\n    return a.originalIndex - b.originalIndex;\n  });\n}\n\nfunction stableKey(query: string, ids: string[]): string {\n  // Keep candidate boundaries explicit; candidate IDs are arbitrary strings.\n  return JSON.stringify([query.trim().toLowerCase(), ids]);\n}\n\nfunction clampSnippet(snippet: string, maxChars: number): string {\n  const s = snippet.replace(/\\s+/g, \" \").trim();\n  return s.length > maxChars ? s.slice(0, maxChars) : s;\n}\n\nexport async function rerankLocalOrNoop(opts: {\n  query: string;\n  candidates: Array<{ id: string; snippet: string }>;\n  local: {\n    chatCompletion: (\n      messages: Array<{ role: string; content: string }>,\n      options?: {\n        maxTokens?: number;\n        temperature?: number;\n        timeoutMs?: number;\n        operation?: string;\n        priority?: \"recall-critical\" | \"background\";\n      }\n    ) => Promise<{ content: string } | null>;\n  };\n  enabled: boolean;\n  timeoutMs: number;\n  maxCandidates: number;\n  cache?: RerankCache;\n  cacheEnabled: boolean;\n  cacheTtlMs: number;\n}): Promise<string[] | null> {\n  if (!opts.enabled) return null;\n\n  const ids = opts.candidates.slice(0, opts.maxCandidates).map((c) => c.id);\n  if (ids.length <= 1) return ids;\n\n  const key = stableKey(opts.query, ids);\n  if (opts.cache && opts.cacheEnabled) {\n    const cached = opts.cache.get(key);\n    if (cached) return cached;\n  }\n\n  const payload = opts.candidates.slice(0, opts.maxCandidates).map((c) => ({\n    id: c.id,\n    snippet: clampSnippet(c.snippet, 400),\n  }));\n\n  const system = \"You are a ranking system. Return JSON only. No markdown, no commentary.\";\n  const user = JSON.stringify(\n    {\n      task: \"rerank\",\n      query: opts.query,\n      candidates: payload,\n      output: {\n        scores: [{ id: \"string\", score: \"number 0-100\" }],\n      },\n      rules: [\n        \"Assign higher score to more relevant candidates.\",\n        \"Prefer durability and direct relevance to the query.\",\n        \"If unsure, keep scores close together.\",\n      ],\n    },\n    null,\n    0\n  );\n\n  const res = await opts.local.chatCompletion(\n    [\n      { role: \"system\", content: system },\n      { role: \"user\", content: user },\n    ],\n    {\n      maxTokens: 800,\n      temperature: 0.0,\n      timeoutMs: opts.timeoutMs,\n      operation: \"rerank\",\n      priority: \"recall-critical\",\n    }\n  );\n  if (!res?.content) return null;\n\n  const parsed = parseRerankResponse(\n    res.content,\n    ids.map((id, i) => ({ id, originalIndex: i }))\n  );\n  const rankedIds = parsed.map((p) => p.id);\n\n  if (opts.cache && opts.cacheEnabled) {\n    opts.cache.set(key, rankedIds, opts.cacheTtlMs);\n  }\n\n  return rankedIds;\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -182,7 +182,7 @@ import {
   saveTaxonomy,
   validateSlug,
   validateTaxonomy
-} from "./chunk-IOTTZLFF.js";
+} from "./chunk-7ZGA7YTS.js";
 import "./chunk-5RIRL3XL.js";
 import {
   migrateFromEngram,
@@ -232,7 +232,7 @@ import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-452WDNFO.js";
-import "./chunk-TDKQGLJW.js";
+import "./chunk-E3VODCC3.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
 import "./chunk-2IT7WFYE.js";

package/dist/orchestrator.js

@@ -26,7 +26,7 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-IOTTZLFF.js";
+} from "./chunk-7ZGA7YTS.js";
 import "./chunk-5RIRL3XL.js";
 import "./chunk-KVEVLBKC.js";
 import "./chunk-BFBF3XEF.js";
@@ -60,7 +60,7 @@ import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-452WDNFO.js";
-import "./chunk-TDKQGLJW.js";
+import "./chunk-E3VODCC3.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
 import "./chunk-2IT7WFYE.js";

package/dist/rerank.js

@@ -2,7 +2,7 @@ import {
   RerankCache,
   parseRerankResponse,
   rerankLocalOrNoop
-} from "./chunk-TDKQGLJW.js";
+} from "./chunk-E3VODCC3.js";
 import "./chunk-PZ5AY32C.js";
 export {
   RerankCache,

package/dist/schemas.d.ts

@@ -275,12 +275,12 @@ declare const EntityMentionSchema: z.ZodObject<{
         title: z.ZodString;
         facts: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }, {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
@@ -288,8 +288,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -298,8 +298,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -584,12 +584,12 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -597,8 +597,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -607,8 +607,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -665,8 +665,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -714,8 +714,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -952,12 +952,12 @@ declare const ExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -965,8 +965,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -975,8 +975,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1047,8 +1047,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1102,8 +1102,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1172,12 +1172,12 @@ declare const ConsolidationResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1185,8 +1185,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1195,8 +1195,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1215,8 +1215,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1235,8 +1235,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;

package/dist/transfer/types.d.ts

@@ -313,13 +313,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -334,13 +334,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -464,13 +464,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -485,13 +485,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -518,13 +518,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -551,13 +551,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -683,13 +683,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -704,13 +704,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -737,13 +737,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -770,13 +770,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -815,13 +815,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -854,13 +854,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.579",
+  "version": "9.3.581",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/rerank.test.ts

@@ -86,3 +86,55 @@ test("rerankLocalOrNoop cache is isolated from caller mutations", async () => {
   assert.deepEqual(second, ["a", "b"]);
   assert.equal(calls, 1);
 });
+
+test("rerankLocalOrNoop cache keys distinguish candidate IDs containing commas", async () => {
+  let calls = 0;
+  const cache = new RerankCache();
+  const commonOptions = {
+    query: "API rate limit issue",
+    local: {
+      async chatCompletion() {
+        calls += 1;
+        return {
+          content: JSON.stringify({
+            scores:
+              calls === 1
+                ? [
+                    { id: "c", score: 90 },
+                    { id: "a,b", score: 10 },
+                  ]
+                : [
+                    { id: "b,c", score: 90 },
+                    { id: "a", score: 10 },
+                  ],
+          }),
+        };
+      },
+    },
+    enabled: true,
+    timeoutMs: 1_500,
+    maxCandidates: 5,
+    cache,
+    cacheEnabled: true,
+    cacheTtlMs: 60_000,
+  };
+
+  const first = await rerankLocalOrNoop({
+    ...commonOptions,
+    candidates: [
+      { id: "a,b", snippet: "API rate limit is 1000 requests per minute." },
+      { id: "c", snippet: "Deployment note." },
+    ],
+  });
+  assert.deepEqual(first, ["c", "a,b"]);
+
+  const second = await rerankLocalOrNoop({
+    ...commonOptions,
+    candidates: [
+      { id: "a", snippet: "API rate limit is 1000 requests per minute." },
+      { id: "b,c", snippet: "Deployment note." },
+    ],
+  });
+  assert.deepEqual(second, ["b,c", "a"]);
+  assert.equal(calls, 2);
+});

package/src/rerank.ts

@@ -41,7 +41,7 @@ export class RerankCache {
  */
 export function parseRerankResponse(
   raw: string,
-  candidates: RerankCandidate[],
+  candidates: RerankCandidate[]
 ): Array<RerankCandidate & { score?: number }> {
   const byId = new Map<string, RerankCandidate>();
   for (const c of candidates) byId.set(c.id, c);
@@ -80,8 +80,8 @@ export function parseRerankResponse(
 }
 
 function stableKey(query: string, ids: string[]): string {
-  // Keep it simple and deterministic; this is not a security boundary.
-  return `${query.trim().toLowerCase()}|${ids.join(",")}`;
+  // Keep candidate boundaries explicit; candidate IDs are arbitrary strings.
+  return JSON.stringify([query.trim().toLowerCase(), ids]);
 }
 
 function clampSnippet(snippet: string, maxChars: number): string {
@@ -101,7 +101,7 @@ export async function rerankLocalOrNoop(opts: {
         timeoutMs?: number;
         operation?: string;
         priority?: "recall-critical" | "background";
-      },
+      }
     ) => Promise<{ content: string } | null>;
   };
   enabled: boolean;
@@ -127,8 +127,7 @@ export async function rerankLocalOrNoop(opts: {
     snippet: clampSnippet(c.snippet, 400),
   }));
 
-  const system =
-    "You are a ranking system. Return JSON only. No markdown, no commentary.";
+  const system = "You are a ranking system. Return JSON only. No markdown, no commentary.";
   const user = JSON.stringify(
     {
       task: "rerank",
@@ -144,7 +143,7 @@ export async function rerankLocalOrNoop(opts: {
       ],
     },
     null,
-    0,
+    0
   );
 
   const res = await opts.local.chatCompletion(
@@ -158,13 +157,13 @@ export async function rerankLocalOrNoop(opts: {
       timeoutMs: opts.timeoutMs,
       operation: "rerank",
       priority: "recall-critical",
-    },
+    }
   );
   if (!res?.content) return null;
 
   const parsed = parseRerankResponse(
     res.content,
-    ids.map((id, i) => ({ id, originalIndex: i })),
+    ids.map((id, i) => ({ id, originalIndex: i }))
   );
   const rankedIds = parsed.map((p) => p.id);
 

package/dist/chunk-TDKQGLJW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rerank.ts"],"sourcesContent":["export interface RerankCandidate {\n  id: string;\n  originalIndex: number;\n}\n\nexport interface RerankScore {\n  id: string;\n  score: number;\n}\n\nexport interface RerankCacheEntry {\n  expiresAtMs: number;\n  rankedIds: string[];\n}\n\nexport class RerankCache {\n  private entries = new Map<string, RerankCacheEntry>();\n\n  get(key: string): string[] | null {\n    const e = this.entries.get(key);\n    if (!e) return null;\n    if (Date.now() > e.expiresAtMs) {\n      this.entries.delete(key);\n      return null;\n    }\n    return e.rankedIds.slice();\n  }\n\n  set(key: string, rankedIds: string[], ttlMs: number): void {\n    this.entries.set(key, { rankedIds: rankedIds.slice(), expiresAtMs: Date.now() + ttlMs });\n  }\n}\n\n/**\n * Parse a rerank response (JSON) and return candidates sorted by score.\n *\n * Rules:\n * - Unknown IDs in the response are ignored.\n * - Candidates missing from the response keep relative order after scored ones.\n * - Stable tie-breaker: originalIndex ascending.\n */\nexport function parseRerankResponse(\n  raw: string,\n  candidates: RerankCandidate[],\n): Array<RerankCandidate & { score?: number }> {\n  const byId = new Map<string, RerankCandidate>();\n  for (const c of candidates) byId.set(c.id, c);\n\n  const scores = new Map<string, number>();\n  try {\n    const parsed = JSON.parse(raw) as { scores?: Array<Partial<RerankScore>> };\n    if (Array.isArray(parsed.scores)) {\n      for (const s of parsed.scores) {\n        if (!s || typeof s.id !== \"string\") continue;\n        if (!byId.has(s.id)) continue;\n        if (typeof s.score !== \"number\" || !Number.isFinite(s.score)) continue;\n        scores.set(s.id, s.score);\n      }\n    }\n  } catch {\n    // Ignore parse errors and fall back to original order.\n  }\n\n  const withScore = candidates.map((c) => ({\n    ...c,\n    score: scores.get(c.id),\n  }));\n\n  return withScore.sort((a, b) => {\n    const as = a.score;\n    const bs = b.score;\n    if (typeof as === \"number\" && typeof bs === \"number\") {\n      if (bs !== as) return bs - as;\n      return a.originalIndex - b.originalIndex;\n    }\n    if (typeof as === \"number\") return -1;\n    if (typeof bs === \"number\") return 1;\n    return a.originalIndex - b.originalIndex;\n  });\n}\n\nfunction stableKey(query: string, ids: string[]): string {\n  // Keep it simple and deterministic; this is not a security boundary.\n  return `${query.trim().toLowerCase()}|${ids.join(\",\")}`;\n}\n\nfunction clampSnippet(snippet: string, maxChars: number): string {\n  const s = snippet.replace(/\\s+/g, \" \").trim();\n  return s.length > maxChars ? s.slice(0, maxChars) : s;\n}\n\nexport async function rerankLocalOrNoop(opts: {\n  query: string;\n  candidates: Array<{ id: string; snippet: string }>;\n  local: {\n    chatCompletion: (\n      messages: Array<{ role: string; content: string }>,\n      options?: {\n        maxTokens?: number;\n        temperature?: number;\n        timeoutMs?: number;\n        operation?: string;\n        priority?: \"recall-critical\" | \"background\";\n      },\n    ) => Promise<{ content: string } | null>;\n  };\n  enabled: boolean;\n  timeoutMs: number;\n  maxCandidates: number;\n  cache?: RerankCache;\n  cacheEnabled: boolean;\n  cacheTtlMs: number;\n}): Promise<string[] | null> {\n  if (!opts.enabled) return null;\n\n  const ids = opts.candidates.slice(0, opts.maxCandidates).map((c) => c.id);\n  if (ids.length <= 1) return ids;\n\n  const key = stableKey(opts.query, ids);\n  if (opts.cache && opts.cacheEnabled) {\n    const cached = opts.cache.get(key);\n    if (cached) return cached;\n  }\n\n  const payload = opts.candidates.slice(0, opts.maxCandidates).map((c) => ({\n    id: c.id,\n    snippet: clampSnippet(c.snippet, 400),\n  }));\n\n  const system =\n    \"You are a ranking system. Return JSON only. No markdown, no commentary.\";\n  const user = JSON.stringify(\n    {\n      task: \"rerank\",\n      query: opts.query,\n      candidates: payload,\n      output: {\n        scores: [{ id: \"string\", score: \"number 0-100\" }],\n      },\n      rules: [\n        \"Assign higher score to more relevant candidates.\",\n        \"Prefer durability and direct relevance to the query.\",\n        \"If unsure, keep scores close together.\",\n      ],\n    },\n    null,\n    0,\n  );\n\n  const res = await opts.local.chatCompletion(\n    [\n      { role: \"system\", content: system },\n      { role: \"user\", content: user },\n    ],\n    {\n      maxTokens: 800,\n      temperature: 0.0,\n      timeoutMs: opts.timeoutMs,\n      operation: \"rerank\",\n      priority: \"recall-critical\",\n    },\n  );\n  if (!res?.content) return null;\n\n  const parsed = parseRerankResponse(\n    res.content,\n    ids.map((id, i) => ({ id, originalIndex: i })),\n  );\n  const rankedIds = parsed.map((p) => p.id);\n\n  if (opts.cache && opts.cacheEnabled) {\n    opts.cache.set(key, rankedIds, opts.cacheTtlMs);\n  }\n\n  return rankedIds;\n}\n"],"mappings":"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","names":[]}