@sigrun/recall 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-11-03
+
+### Added
+
+- The search route accepts `?exclude=<conversationId>` so callers can reproduce auto-recall's exclusion of the current conversation (eval fidelity).
+- The eval harness (`scripts/recall-eval.ts`) supports a per-pair `exclude` field with client-side filtering, and over-fetches when excluding so filtered hits don't consume the top-k window.
+
+### Fixed
+
+- (from polish wave 1, 0.1.2) The shutdown drain is bounded and its race timer clears on fast settles.
+
+## [0.1.2] - Unreleased
+
+### Fixed
+
+- Bound the shutdown drain: each round races `Promise.allSettled(pending)` against a timer for the remaining budget, so a capture whose embedding fetch never settles can no longer hang `harnessShutdown` past the 30s deadline; the database still closes.
+
 ## [0.1.1] - Unreleased
 
 ### Fixed

package/dist/index.d.ts

@@ -3,6 +3,8 @@ import { RecallDb } from "./db.js";
 export interface FactoryDeps {
     openDb?: (path: string) => RecallDb;
     now?: () => number;
+    /** Test seam: fetch implementation for the embeddings endpoint. */
+    fetchImpl?: typeof fetch;
 }
 /**
  * The loader injects the host only when factory.length > 0: keep the host

package/dist/index.js

@@ -37,7 +37,7 @@ export default function createRecall(host, deps = {}) {
             return {};
         const key = JSON.stringify(settings.embedding);
         if (embedder === undefined || embeddingKey !== key) {
-            embedder = createEmbedder(settings.embedding, () => host.stores.secrets.get("embedding-api-key"));
+            embedder = createEmbedder(settings.embedding, () => host.stores.secrets.get("embedding-api-key"), deps.fetchImpl);
             embeddingKey = key;
         }
         return {
@@ -206,7 +206,18 @@ export default function createRecall(host, deps = {}) {
         harnessShutdown: async () => {
             const deadline = Date.now() + 30_000;
             while (pending.size > 0 && Date.now() < deadline) {
-                await Promise.allSettled([...pending]);
+                const remaining = deadline - Date.now();
+                // A capture promise may never settle (a hung embedding fetch); race
+                // each round against the remaining budget so the drain always
+                // returns by the deadline. The losing timer is cleared so the
+                // common fast-settle case leaves no live timer behind.
+                let timer;
+                await Promise.race([
+                    Promise.allSettled([...pending]),
+                    new Promise((resolve) => {
+                        timer = setTimeout(() => resolve([]), remaining);
+                    }),
+                ]).finally(() => clearTimeout(timer));
             }
             database?.close();
             database = undefined;

package/dist/route.js

@@ -11,9 +11,12 @@ export function createRoutes(deps) {
                 const url = new URL(request.url);
                 const requested = Number(url.searchParams.get("limit") ?? 20);
                 const limit = Number.isFinite(requested) ? Math.max(1, Math.min(100, Math.trunc(requested))) : 20;
+                const exclude = Number(url.searchParams.get("exclude"));
+                const excludeConversation = Number.isInteger(exclude) && exclude > 0 ? exclude : undefined;
                 const hits = await deps.searcher.search(url.searchParams.get("q") ?? "", {
                     current: { conversationId: undefined, owner: ctx.principal.user },
                     model: undefined,
+                    excludeConversation,
                     includeJobs: true,
                 }, limit);
                 return Response.json({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sigrun/recall",
-	"version": "0.1.1",
+	"version": "0.1.3",
 	"description": "Cross-conversation recall extension for sigrun (pi-durable)",
 	"type": "module",
 	"engines": {