@companion-ai/feynman 0.5.11 → 0.5.12

package/RELEASES.md

@@ -6,6 +6,10 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.12 - 2026-09-28
+
+- Crossref pacing leaves a margin over the pool's limit and retries a rate-limited request once after the server's `Retry-After`. A stress test of three bursts of 10 parallel searches on the public pool now succeeds on all 30; 0.5.11 still lost about one in six to network jitter.
+
 ## v0.5.11 - 2026-09-27
 
 - **Crossref lookups no longer fail in bursts.** Crossref's public pool allows one request at a time, one per second, and parallel DOI checks (the verifier cross-checks every citation) got `429 Too Many Requests` on most calls. Crossref requests now run one after another at the pool's pace. Set `CROSSREF_MAILTO` to your email for Crossref's faster polite pool; a 429 now says so instead of a generic "Science database request failed".

package/extensions/research-tools/science-databases.ts

@@ -145,7 +145,9 @@ let crossrefQueue: Promise<unknown> = Promise.resolve();
 let crossrefLastStartedAt = Number.NEGATIVE_INFINITY;
 
 export function withCrossrefPacing<T>(polite: boolean, run: () => Promise<T>): Promise<T> {
-	const minGapMs = polite ? 350 : 1000;
+	// A little over the pool's limit: network jitter can land two requests paced
+	// exactly one second apart inside the same window.
+	const minGapMs = polite ? 400 : 1200;
 	const next = crossrefQueue.then(async () => {
 		const wait = crossrefLastStartedAt + minGapMs - Date.now();
 		if (wait > 0) await new Promise((resolve) => setTimeout(resolve, wait));
@@ -167,9 +169,16 @@ async function searchCrossref(params: ScienceDatabaseSearchParams): Promise<Reco
 		select: "DOI,title,published-print,published-online,issued,container-title,author,is-referenced-by-count,URL,type",
 		...(mailto ? { mailto } : {}),
 	}).toString();
+	const request = () => withCrossrefPacing(Boolean(mailto), () => fetchJson(url));
 	let payload: Record<string, unknown>;
 	try {
-		payload = recordValue(await withCrossrefPacing(Boolean(mailto), () => fetchJson(url)));
+		try {
+			payload = recordValue(await request());
+		} catch (error) {
+			if (!(error instanceof ScienceDatabaseRequestError) || error.status !== 429) throw error;
+			await new Promise((resolve) => setTimeout(resolve, Math.min(error.retryAfterMs ?? 1500, 5000)));
+			payload = recordValue(await request());
+		}
 	} catch (error) {
 		if (!(error instanceof ScienceDatabaseRequestError) || error.status !== 429) throw error;
 		throw new Error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",