@remnic/core 9.69.26 → 9.69.28

package/dist/connectors/index.js

@@ -34,7 +34,7 @@ import "../chunk-C5C7IJ4Q.js";
 import "../chunk-EMDLM3LW.js";
 import {
   runCodexMaterialize
-} from "../chunk-KAXCYM66.js";
+} from "../chunk-U6S754L6.js";
 import "../chunk-3UXOZBHV.js";
 import {
   MATERIALIZE_VERSION,
@@ -51,12 +51,12 @@ import {
   truncateToTokenBudget,
   validateMemoryMd
 } from "../chunk-KEF46KL2.js";
-import "../chunk-XSGUMQQQ.js";
+import "../chunk-UY2RORVF.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-46WM6JX2.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-2Z4GS5E6.js";
-import "../chunk-6CVNSDCZ.js";
+import "../chunk-ZMNT26KV.js";
+import "../chunk-RFWEDCRC.js";
 import "../chunk-BD7JTBYP.js";
 import "../chunk-OB3XMWX5.js";
 import "../chunk-CYEPCZN5.js";
@@ -65,10 +65,10 @@ import "../chunk-YQNNHLCG.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
+import "../chunk-7RZJWZ46.js";
+import "../chunk-A7Q43EUZ.js";
 import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
-import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-SO7SV523.js";
 import "../chunk-SCU65EZI.js";
@@ -90,10 +90,10 @@ import "../chunk-RBOJCG4T.js";
 import "../chunk-R7QY5ZVB.js";
 import "../chunk-5WITETWU.js";
 import "../chunk-6CIAGZ6X.js";
-import "../chunk-CEH2AFXG.js";
+import "../chunk-C24UZSFW.js";
 import "../chunk-JXN77SGO.js";
-import "../chunk-IUM3VSHI.js";
 import "../chunk-ZLQ37WJX.js";
+import "../chunk-IUM3VSHI.js";
 import "../chunk-3QQTXYZ6.js";
 import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";

package/dist/convergence-refresh.js

@@ -1,16 +1,16 @@
 import {
   refreshConvergedNamespaces
-} from "./chunk-6NXSYYGP.js";
-import "./chunk-JEC4DVM3.js";
+} from "./chunk-HLTAZTN7.js";
+import "./chunk-ZNR5SVUI.js";
 import "./chunk-KJTKLXTH.js";
 import "./chunk-2DQ2XREU.js";
-import "./chunk-MY5EDR46.js";
-import "./chunk-XSGUMQQQ.js";
+import "./chunk-I3OQBP23.js";
+import "./chunk-UY2RORVF.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-2Z4GS5E6.js";
-import "./chunk-6CVNSDCZ.js";
+import "./chunk-ZMNT26KV.js";
+import "./chunk-RFWEDCRC.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
 import "./chunk-CYEPCZN5.js";
@@ -19,10 +19,10 @@ import "./chunk-YQNNHLCG.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
@@ -44,10 +44,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/conversation-index/backend.js

@@ -1,9 +1,9 @@
 import {
   createConversationIndexBackend
-} from "../chunk-227UFSEQ.js";
+} from "../chunk-7RZJWZ46.js";
+import "../chunk-A7Q43EUZ.js";
 import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
-import "../chunk-A7Q43EUZ.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-3WCASNQZ.js";
 import "../chunk-PZ5AY32C.js";

package/dist/corpus-watermark.js

@@ -9,15 +9,15 @@ import {
   computeServiceCorpusWatermarks,
   digestPartitionCensus,
   resolveCorpusNamespaceRoots
-} from "./chunk-AQ7SYDVO.js";
-import "./chunk-RBCQVOVJ.js";
-import "./chunk-E2P7TZTF.js";
-import "./chunk-XSGUMQQQ.js";
+} from "./chunk-5PTRLTK2.js";
+import "./chunk-WOOTZ6DH.js";
+import "./chunk-HTPQJ32S.js";
+import "./chunk-UY2RORVF.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-2Z4GS5E6.js";
-import "./chunk-6CVNSDCZ.js";
+import "./chunk-ZMNT26KV.js";
+import "./chunk-RFWEDCRC.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
 import "./chunk-CYEPCZN5.js";
@@ -26,10 +26,10 @@ import "./chunk-YQNNHLCG.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
@@ -51,10 +51,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/deep-recall-http-glue.d.ts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { f as EngramAccessService } from './access-service-Cv8Rizo0.js';
+import { f as EngramAccessService } from './access-service-GrdVg_-Z.js';
 import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';

package/dist/deep-recall-http-glue.js

@@ -1,10 +1,10 @@
 import {
   respondDeepRecall
-} from "./chunk-GHTSNGBZ.js";
-import "./chunk-N3ZOP7KC.js";
-import "./chunk-VDX2J7OX.js";
+} from "./chunk-ALBYEXFX.js";
+import "./chunk-2AMEUKCG.js";
+import "./chunk-7LCGFUMB.js";
+import "./chunk-X7Y7WX73.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/deep-recall-mcp-tools.d.ts

@@ -1,4 +1,4 @@
-import { K as McpTool } from './access-service-Cv8Rizo0.js';
+import { K as McpTool } from './access-service-GrdVg_-Z.js';
 import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';

package/dist/entity-retrieval.js

@@ -3,19 +3,19 @@ import {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-4TKJGOCJ.js";
+} from "./chunk-YGTSOVCR.js";
 import "./chunk-GKUA4MGB.js";
 import "./chunk-5AUY5Z5E.js";
 import "./chunk-SVH57F5Z.js";
 import "./chunk-MKYRCCSN.js";
 import "./chunk-2DQ2XREU.js";
 import "./chunk-7ZNJN5WZ.js";
-import "./chunk-XSGUMQQQ.js";
+import "./chunk-UY2RORVF.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-2Z4GS5E6.js";
-import "./chunk-6CVNSDCZ.js";
+import "./chunk-ZMNT26KV.js";
+import "./chunk-RFWEDCRC.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
 import "./chunk-CYEPCZN5.js";
@@ -24,10 +24,10 @@ import "./chunk-YQNNHLCG.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
@@ -49,10 +49,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/external-wiki-access.d.ts

@@ -1,4 +1,4 @@
-import { B as BoundOperation } from './access-service-Cv8Rizo0.js';
+import { B as BoundOperation } from './access-service-GrdVg_-Z.js';
 import { ExternalWikiSearchResult, ExternalWikiSearchInput } from './external-wiki-search.js';
 import './types-YY-eKKU7.js';
 import './message-parts/index.js';

package/dist/external-wiki-access.js

@@ -1,17 +1,17 @@
 import {
   externalWikiSearchOperation
-} from "./chunk-RX3SC4C5.js";
+} from "./chunk-NVOFMARR.js";
 import "./chunk-7T4TOGMS.js";
 import "./chunk-7YQ6ESEA.js";
-import "./chunk-OU4K7IFP.js";
+import "./chunk-R55WAWS3.js";
 import "./chunk-W4F3C7N7.js";
 import "./chunk-MPC7TYTZ.js";
-import "./chunk-VVX5PZFS.js";
+import "./chunk-TDYAIXHK.js";
 import "./chunk-CC37E3QM.js";
 import "./chunk-ND6IQGSZ.js";
 import "./chunk-VQ7B2Q6M.js";
 import "./chunk-PJSK6OJM.js";
-import "./chunk-2EKJDQZB.js";
+import "./chunk-INBOGQ3E.js";
 import "./chunk-GNVZQ5JN.js";
 import "./chunk-YN2UN7N3.js";
 import "./chunk-ROBHL3GL.js";
@@ -24,7 +24,7 @@ import "./chunk-H7XKCNR6.js";
 import "./chunk-22FVR2KE.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-2JVJ7UHC.js";
-import "./chunk-EOQ6FSQP.js";
+import "./chunk-OYHGTHVX.js";
 import "./chunk-CVILPI77.js";
 import "./chunk-6WHJ2EAB.js";
 import "./chunk-AQEJKOKI.js";
@@ -33,7 +33,7 @@ import "./chunk-UD7UNYRD.js";
 import "./chunk-IISBCCWR.js";
 import "./chunk-2YA5N2BY.js";
 import "./chunk-HWLIMQE2.js";
-import "./chunk-6XL73HQ4.js";
+import "./chunk-3FEH4C4V.js";
 import "./chunk-EI6V5UXY.js";
 import "./chunk-3GCK6ONU.js";
 import "./chunk-YSSAGB2O.js";
@@ -56,13 +56,13 @@ import "./chunk-HRATODNO.js";
 import "./chunk-BMWN7B3Y.js";
 import "./chunk-DXFG2VGN.js";
 import "./chunk-RF2SMMPP.js";
-import "./chunk-MY5EDR46.js";
-import "./chunk-AQ7SYDVO.js";
-import "./chunk-RBCQVOVJ.js";
-import "./chunk-E2P7TZTF.js";
+import "./chunk-I3OQBP23.js";
+import "./chunk-5PTRLTK2.js";
+import "./chunk-WOOTZ6DH.js";
+import "./chunk-HTPQJ32S.js";
 import "./chunk-UFGFMWAD.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-KAXCYM66.js";
+import "./chunk-U6S754L6.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-KEF46KL2.js";
 import "./chunk-5FAGCOZD.js";
@@ -71,13 +71,13 @@ import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-LXY5VVGM.js";
 import "./chunk-GKCXTSFF.js";
-import "./chunk-WJHGDE7X.js";
-import "./chunk-XSGUMQQQ.js";
+import "./chunk-NC7RM2XS.js";
+import "./chunk-UY2RORVF.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-2Z4GS5E6.js";
-import "./chunk-6CVNSDCZ.js";
+import "./chunk-ZMNT26KV.js";
+import "./chunk-RFWEDCRC.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
 import "./chunk-CYEPCZN5.js";
@@ -86,10 +86,10 @@ import "./chunk-YQNNHLCG.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
@@ -112,15 +112,15 @@ import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-UBCBDJOB.js";
-import "./chunk-FHYVNJBN.js";
+import "./chunk-6TZWGQTT.js";
 import "./chunk-MT47LH5L.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";
@@ -180,9 +180,9 @@ import "./chunk-EEOUMG3J.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-7LCGFUMB.js";
+import "./chunk-X7Y7WX73.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/external-wiki-mcp-tools.d.ts

@@ -1,4 +1,4 @@
-import { K as McpTool } from './access-service-Cv8Rizo0.js';
+import { K as McpTool } from './access-service-GrdVg_-Z.js';
 import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';

package/dist/extraction.js

@@ -1,8 +1,8 @@
 import {
   ExtractionEngine,
   shouldEnableLocalExtractionThinking
-} from "./chunk-DDB3S53L.js";
-import "./chunk-XTJC7CVX.js";
+} from "./chunk-WW3MR6T3.js";
+import "./chunk-XR67IAXP.js";
 import "./chunk-AJTG3CP7.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-2CGLBUW3.js";
@@ -31,15 +31,15 @@ import "./chunk-WLZYGLJ4.js";
 import "./chunk-IVKIODHO.js";
 import "./chunk-WKDFJXW5.js";
 import "./chunk-JUXOTY6J.js";
-import "./chunk-KAXCYM66.js";
+import "./chunk-U6S754L6.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-KEF46KL2.js";
-import "./chunk-XSGUMQQQ.js";
+import "./chunk-UY2RORVF.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-2Z4GS5E6.js";
-import "./chunk-6CVNSDCZ.js";
+import "./chunk-ZMNT26KV.js";
+import "./chunk-RFWEDCRC.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
 import "./chunk-CYEPCZN5.js";
@@ -48,10 +48,10 @@ import "./chunk-YQNNHLCG.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
@@ -73,15 +73,15 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-FHYVNJBN.js";
+import "./chunk-6TZWGQTT.js";
 import "./chunk-MT47LH5L.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/harmonic-retrieval.js

@@ -3,7 +3,7 @@ import {
   readCueAnchors,
   readProjectedHarmonicGraph,
   searchHarmonicRetrieval
-} from "./chunk-6XL73HQ4.js";
+} from "./chunk-3FEH4C4V.js";
 import "./chunk-BMWN7B3Y.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-YCVB7X56.js";

package/dist/http-retry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared retrying fetch for connector packages (issue #2792).
+ *
+ * One copy of the retry loop that six connector clients and the X MCP
+ * client duplicated: attempt counting, per-attempt timeout signal,
+ * 429/5xx retry with Retry-After (seconds or HTTP-date) plus capped
+ * exponential backoff, raw rethrow of caller aborts, and socket
+ * release on retryable responses. Vendors keep everything
+ * request-specific: headers/body, the error classes their callers
+ * match on, and what happens to a successful response body.
+ *
+ * Import via the `@remnic/core/http-retry` subpath (same pattern as
+ * `@remnic/core/abort-error`) — the root index stays untouched.
+ */
+interface RetryingFetchOptions {
+    /** Request init for every attempt. Ignored when `buildInit` is set. */
+    init?: RequestInit;
+    /**
+     * Init builder invoked ONCE, before the retry loop. Request
+     * construction (e.g. token acquisition) must stay outside the
+     * transport retry boundary: a deterministic provider failure —
+     * missing grant, revoked grant, unpersistable token file — runs once
+     * and propagates unwrapped, never retried or vendor-wrapped.
+     */
+    buildInit?: () => RequestInit | Promise<RequestInit>;
+    fetchImpl?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** Retries after the first attempt. Default 3 (4 attempts total). */
+    maxRetries?: number;
+    maxRetryDelayMs?: number;
+    /** First backoff step; doubles per attempt. Default 1_000. */
+    backoffBaseMs?: number;
+    /**
+     * Vendor Retry-After parsing (e.g. a body field). A `null`/`undefined`
+     * result falls back to the shared Retry-After header parse, then to
+     * exponential backoff. A number (including 0) is used as-is.
+     */
+    retryAfterMs?: (response: Response) => number | null | undefined | Promise<number | null | undefined>;
+    /** Wraps an exhausted network/timeout failure into the vendor error. */
+    networkError: (err: unknown, attempts: number, context: NetworkErrorContext) => Error;
+    /** Wraps a retryable (429/5xx) response; thrown when retries are exhausted. */
+    retryableError: (response: Response) => Error | Promise<Error>;
+}
+interface NetworkErrorContext {
+    /** True when the helper's own timeout signal fired (not a caller abort). */
+    timedOut: boolean;
+}
+/**
+ * Base class for connector API errors: a message plus optional HTTP
+ * status and vendor detail. Vendor subclasses set their own `name`.
+ */
+declare class ConnectorApiError extends Error {
+    readonly status?: number | undefined;
+    readonly detail?: string | undefined;
+    constructor(message: string, status?: number | undefined, detail?: string | undefined);
+}
+/**
+ * Network/timeout failures wrap Node error text that can carry loader
+ * paths or stack fragments; sync errors reach MCP clients verbatim, so
+ * only the error name + code survive.
+ */
+declare function describeNetworkError(err: unknown): string;
+/** Loop instead of `/\/+$/` — CodeQL js/polynomial-redos on user-set URLs. */
+declare function stripTrailingSlashes(value: string): string;
+/** Release the socket back to the pool: an unconsumed response body pins the undici connection. */
+declare function discardResponseBody(response: Response): void;
+/**
+ * Parse a `Retry-After` header as delay in ms, capped at `capMs`:
+ * delay-seconds first, then HTTP-date. `undefined` when absent or
+ * unparseable.
+ */
+declare function retryAfterHeaderMs(response: Response, capMs: number): number | undefined;
+/**
+ * Fetch with retries on network failures, 429, and 5xx. Returns the
+ * final response (ok or non-retryable status) for the caller to
+ * interpret; throws the vendor-wrapped error when retries are exhausted
+ * or the transport fails.
+ */
+declare function retryingFetch(url: string, options: RetryingFetchOptions): Promise<Response>;
+
+export { ConnectorApiError, type NetworkErrorContext, type RetryingFetchOptions, describeNetworkError, discardResponseBody, retryAfterHeaderMs, retryingFetch, stripTrailingSlashes };

package/dist/http-retry.js

@@ -0,0 +1,101 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/http-retry.ts
+var ConnectorApiError = class extends Error {
+  constructor(message, status, detail) {
+    super(message);
+    this.status = status;
+    this.detail = detail;
+    this.name = "ConnectorApiError";
+  }
+  status;
+  detail;
+};
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_MAX_RETRY_DELAY_MS = 3e4;
+var DEFAULT_BACKOFF_BASE_MS = 1e3;
+function defaultSleep(ms) {
+  const { promise, resolve } = Promise.withResolvers();
+  setTimeout(resolve, ms);
+  return promise;
+}
+function describeNetworkError(err) {
+  if (!(err instanceof Error)) return "unexpected non-Error failure";
+  const code = err.code;
+  return typeof code === "string" && code.length > 0 ? `${err.name} (${code})` : err.name;
+}
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
+function discardResponseBody(response) {
+  void response.body?.cancel().catch(() => {
+  });
+}
+function retryAfterHeaderMs(response, capMs) {
+  const header = response.headers.get("retry-after");
+  if (header === null || header.length === 0) return void 0;
+  const seconds = Number(header);
+  if (Number.isFinite(seconds) && seconds >= 0) {
+    return Math.min(capMs, Math.ceil(seconds * 1e3));
+  }
+  const when = Date.parse(header);
+  if (Number.isFinite(when)) {
+    return Math.min(capMs, Math.max(0, when - Date.now()));
+  }
+  return void 0;
+}
+async function retryingFetch(url, options) {
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const sleep = options.sleep ?? defaultSleep;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const maxRetryDelayMs = options.maxRetryDelayMs ?? DEFAULT_MAX_RETRY_DELAY_MS;
+  const backoffBaseMs = options.backoffBaseMs ?? DEFAULT_BACKOFF_BASE_MS;
+  const backoffMs = (attempt) => Math.min(maxRetryDelayMs, backoffBaseMs * 2 ** attempt);
+  const attempts = maxRetries + 1;
+  options.signal?.throwIfAborted();
+  const init = options.buildInit ? await options.buildInit() : options.init;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    options.signal?.throwIfAborted();
+    const timeoutSignal = AbortSignal.timeout(timeoutMs);
+    const combined = options.signal ? AbortSignal.any([options.signal, timeoutSignal]) : timeoutSignal;
+    let response;
+    try {
+      response = await fetchImpl(url, { ...init, signal: combined });
+    } catch (err) {
+      if (options.signal?.aborted) throw err;
+      if (attempt < maxRetries) {
+        await sleep(backoffMs(attempt));
+        continue;
+      }
+      throw options.networkError(err, attempts, { timedOut: timeoutSignal.aborted });
+    }
+    if (response.status === 429 || response.status >= 500) {
+      lastError = await options.retryableError(response);
+      if (attempt < maxRetries) {
+        const override = options.retryAfterMs ? await options.retryAfterMs(response) : void 0;
+        const delay = override ?? retryAfterHeaderMs(response, maxRetryDelayMs) ?? backoffMs(attempt);
+        discardResponseBody(response);
+        await sleep(delay);
+        continue;
+      }
+      discardResponseBody(response);
+      throw lastError;
+    }
+    return response;
+  }
+  throw lastError instanceof Error ? lastError : new ConnectorApiError("request failed");
+}
+export {
+  ConnectorApiError,
+  describeNetworkError,
+  discardResponseBody,
+  retryAfterHeaderMs,
+  retryingFetch,
+  stripTrailingSlashes
+};
+//# sourceMappingURL=http-retry.js.map

package/dist/http-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http-retry.ts"],"sourcesContent":["/**\n * Shared retrying fetch for connector packages (issue #2792).\n *\n * One copy of the retry loop that six connector clients and the X MCP\n * client duplicated: attempt counting, per-attempt timeout signal,\n * 429/5xx retry with Retry-After (seconds or HTTP-date) plus capped\n * exponential backoff, raw rethrow of caller aborts, and socket\n * release on retryable responses. Vendors keep everything\n * request-specific: headers/body, the error classes their callers\n * match on, and what happens to a successful response body.\n *\n * Import via the `@remnic/core/http-retry` subpath (same pattern as\n * `@remnic/core/abort-error`) — the root index stays untouched.\n */\n\nexport interface RetryingFetchOptions {\n  /** Request init for every attempt. Ignored when `buildInit` is set. */\n  init?: RequestInit;\n  /**\n   * Init builder invoked ONCE, before the retry loop. Request\n   * construction (e.g. token acquisition) must stay outside the\n   * transport retry boundary: a deterministic provider failure —\n   * missing grant, revoked grant, unpersistable token file — runs once\n   * and propagates unwrapped, never retried or vendor-wrapped.\n   */\n  buildInit?: () => RequestInit | Promise<RequestInit>;\n  fetchImpl?: typeof fetch;\n  sleep?: (ms: number) => Promise<void>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Retries after the first attempt. Default 3 (4 attempts total). */\n  maxRetries?: number;\n  maxRetryDelayMs?: number;\n  /** First backoff step; doubles per attempt. Default 1_000. */\n  backoffBaseMs?: number;\n  /**\n   * Vendor Retry-After parsing (e.g. a body field). A `null`/`undefined`\n   * result falls back to the shared Retry-After header parse, then to\n   * exponential backoff. A number (including 0) is used as-is.\n   */\n  retryAfterMs?: (response: Response) => number | null | undefined | Promise<number | null | undefined>;\n  /** Wraps an exhausted network/timeout failure into the vendor error. */\n  networkError: (err: unknown, attempts: number, context: NetworkErrorContext) => Error;\n  /** Wraps a retryable (429/5xx) response; thrown when retries are exhausted. */\n  retryableError: (response: Response) => Error | Promise<Error>;\n}\n\nexport interface NetworkErrorContext {\n  /** True when the helper's own timeout signal fired (not a caller abort). */\n  timedOut: boolean;\n}\n\n/**\n * Base class for connector API errors: a message plus optional HTTP\n * status and vendor detail. Vendor subclasses set their own `name`.\n */\nexport class ConnectorApiError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = \"ConnectorApiError\";\n  }\n}\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_MAX_RETRY_DELAY_MS = 30_000;\nconst DEFAULT_BACKOFF_BASE_MS = 1_000;\n\nfunction defaultSleep(ms: number): Promise<void> {\n  const { promise, resolve } = Promise.withResolvers<void>();\n  setTimeout(resolve, ms);\n  return promise;\n}\n\n/**\n * Network/timeout failures wrap Node error text that can carry loader\n * paths or stack fragments; sync errors reach MCP clients verbatim, so\n * only the error name + code survive.\n */\nexport function describeNetworkError(err: unknown): string {\n  if (!(err instanceof Error)) return \"unexpected non-Error failure\";\n  const code = (err as NodeJS.ErrnoException).code;\n  return typeof code === \"string\" && code.length > 0 ? `${err.name} (${code})` : err.name;\n}\n\n/** Loop instead of `/\\/+$/` — CodeQL js/polynomial-redos on user-set URLs. */\nexport function stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 0x2f) end--;\n  return value.slice(0, end);\n}\n\n/** Release the socket back to the pool: an unconsumed response body pins the undici connection. */\nexport function discardResponseBody(response: Response): void {\n  void response.body?.cancel().catch(() => {});\n}\n\n/**\n * Parse a `Retry-After` header as delay in ms, capped at `capMs`:\n * delay-seconds first, then HTTP-date. `undefined` when absent or\n * unparseable.\n */\nexport function retryAfterHeaderMs(response: Response, capMs: number): number | undefined {\n  const header = response.headers.get(\"retry-after\");\n  if (header === null || header.length === 0) return undefined;\n  const seconds = Number(header);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(capMs, Math.ceil(seconds * 1_000));\n  }\n  const when = Date.parse(header);\n  if (Number.isFinite(when)) {\n    return Math.min(capMs, Math.max(0, when - Date.now()));\n  }\n  return undefined;\n}\n\n/**\n * Fetch with retries on network failures, 429, and 5xx. Returns the\n * final response (ok or non-retryable status) for the caller to\n * interpret; throws the vendor-wrapped error when retries are exhausted\n * or the transport fails.\n */\nexport async function retryingFetch(\n  url: string,\n  options: RetryingFetchOptions,\n): Promise<Response> {\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const sleep = options.sleep ?? defaultSleep;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n  const maxRetryDelayMs = options.maxRetryDelayMs ?? DEFAULT_MAX_RETRY_DELAY_MS;\n  const backoffBaseMs = options.backoffBaseMs ?? DEFAULT_BACKOFF_BASE_MS;\n  const backoffMs = (attempt: number): number =>\n    Math.min(maxRetryDelayMs, backoffBaseMs * 2 ** attempt);\n  const attempts = maxRetries + 1;\n\n  // Request construction runs once, outside the retry boundary: only\n  // fetch/network/HTTP-retryable failures retry, so initializer/token\n  // provider errors execute once and propagate unchanged (issue #2792).\n  options.signal?.throwIfAborted();\n  const init = options.buildInit ? await options.buildInit() : options.init;\n\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    options.signal?.throwIfAborted();\n    const timeoutSignal = AbortSignal.timeout(timeoutMs);\n    const combined = options.signal\n      ? AbortSignal.any([options.signal, timeoutSignal])\n      : timeoutSignal;\n    let response: Response;\n    try {\n      response = await fetchImpl(url, { ...init, signal: combined });\n    } catch (err) {\n      // The caller's abort always propagates unwrapped and unretried.\n      if (options.signal?.aborted) throw err;\n      if (attempt < maxRetries) {\n        await sleep(backoffMs(attempt));\n        continue;\n      }\n      throw options.networkError(err, attempts, { timedOut: timeoutSignal.aborted });\n    }\n\n    if (response.status === 429 || response.status >= 500) {\n      lastError = await options.retryableError(response);\n      if (attempt < maxRetries) {\n        const override = options.retryAfterMs ? await options.retryAfterMs(response) : undefined;\n        const delay = override ?? retryAfterHeaderMs(response, maxRetryDelayMs) ?? backoffMs(attempt);\n        discardResponseBody(response);\n        await sleep(delay);\n        continue;\n      }\n      discardResponseBody(response);\n      throw lastError;\n    }\n    return response;\n  }\n  // Unreachable: every terminal loop path throws. Kept for exhaustiveness.\n  throw lastError instanceof Error ? lastError : new ConnectorApiError(\"request failed\");\n}\n"],"mappings":"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","names":[]}