@memnexus-ai/cli 1.7.218 → 1.7.219

package/dist/commands/memories.d.ts

@@ -1,4 +1,5 @@
 import { Command } from 'commander';
+import { isRateLimitError, isServiceUnavailableError, isQuotaError, getRetryAfterMs, sleep } from '../lib/retry';
 /** Number of deletions within the window that triggers the guard. */
 export declare const BULK_DELETE_GUARD_THRESHOLD = 5;
 /** Rolling window in milliseconds (60 seconds). */
@@ -66,16 +67,7 @@ export declare function parseBatchIds(values: string[] | undefined): string[];
 export declare function isValidIsoDate(value: string): boolean;
 /** Split ids into pages of at most `size` (default 100). */
 export declare function chunkIds(ids: string[], size?: number): string[][];
-/** True when an error is an HTTP 429 (rate limited). */
-export declare function isRateLimitError(error: any): boolean;
-/**
- * Extract the server's Retry-After hint in milliseconds, or null if absent.
- * The API surfaces it as a body field (`retryAfter`, seconds) on 429s
- * (see lib/errors.ts) and may also send a Retry-After header; we honor both.
- */
-export declare function getRetryAfterMs(error: any): number | null;
-/** Promise-based sleep. Extracted so tests can inject a no-op/spy. */
-export declare function sleep(ms: number): Promise<void>;
+export { isRateLimitError, isServiceUnavailableError, isQuotaError, getRetryAfterMs, sleep };
 export interface BulkDeleteDeps {
     /** Deletes one page (≤100 ids) and returns the server's counts. */
     deleteFn: (ids: string[]) => Promise<BulkDeleteResult>;
@@ -152,12 +144,8 @@ export declare const BATCH_CREATE_MAX_LINE_BYTES: number;
  * single-create, out of scope for the streaming path (noted in the PR).
  */
 export declare const BATCH_CREATE_ALLOWED_KEYS: Set<string>;
-/** True when an error is an HTTP 503 (service unavailable — transient). */
-export declare function isServiceUnavailableError(error: any): boolean;
 /** True when a create should be retried: 429 (rate limited) or 503 (transient). */
 export declare function isRetryableCreateError(error: any): boolean;
-/** True when an error is an HTTP 402 (quota / payment required). */
-export declare function isQuotaError(error: any): boolean;
 export interface BatchCreateItem {
     /** 1-based input line number (blank lines are skipped, so this is not dense). */
     line: number;

package/dist/commands/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/commands/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,mDAAmD;AACnD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CA0B5E;AA0CD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzE;AA0RD,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAUpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,MAA4B,GAAG,MAAM,EAAE,EAAE,CAMtF;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAoBzD;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,6CAA6C;IAC7C,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACpF,GACA,OAAO,CAAC,qBAAqB,CAAC,CA8ChC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACrC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC1C,QAAQ,GAAE,MAAmC,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAwKD,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,QAAoB,CAAC;AAC9D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,aAapC,CAAC;AAEH,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAG7D;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE1D;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAGhD;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAuFA;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAA2C,GACjE,MAAM,CAoBR;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EAAE,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA0G7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAUpE;AAED,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,MAAM;IAH/B,QAAQ,CAAC,IAAI,qBAAqB;gBAEhB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;CAKhC;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,GAAE,MAAqC,GAC9C,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,GAAE,MAAqC,GACnD,OAAO,CAAC,IAAI,CAAC,CAqFf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAikD/D;AAoYD;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAkN1E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAwErE;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAkE1E;AA0DD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA2H7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAwF7D;AAoGD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAuH5D;AAkOD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAyNnE"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/commands/memories.ts"],"names":[],"mappings":"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"}

package/dist/commands/memories.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StdinTooLargeError = exports.BATCH_CREATE_ALLOWED_KEYS = exports.BATCH_CREATE_MAX_LINE_BYTES = exports.BATCH_CREATE_MAX_STDIN_BYTES = exports.BATCH_CREATE_MAX_RETRIES = exports.BATCH_CREATE_CONCURRENCY_MAX = exports.BATCH_CREATE_CONCURRENCY_MIN = exports.BATCH_CREATE_DEFAULT_CONCURRENCY = exports.BULK_DELETE_LIST_PAGE_SIZE = exports.BULK_DELETE_MAX_RETRIES = exports.BULK_DELETE_PAGE_PAUSE_MS = exports.BULK_DELETE_MAX_IDS = exports.BULK_DELETE_GUARD_WINDOW_MS = exports.BULK_DELETE_GUARD_THRESHOLD = void 0;
+exports.StdinTooLargeError = exports.BATCH_CREATE_ALLOWED_KEYS = exports.BATCH_CREATE_MAX_LINE_BYTES = exports.BATCH_CREATE_MAX_STDIN_BYTES = exports.BATCH_CREATE_MAX_RETRIES = exports.BATCH_CREATE_CONCURRENCY_MAX = exports.BATCH_CREATE_CONCURRENCY_MIN = exports.BATCH_CREATE_DEFAULT_CONCURRENCY = exports.sleep = exports.getRetryAfterMs = exports.isQuotaError = exports.isServiceUnavailableError = exports.isRateLimitError = exports.BULK_DELETE_LIST_PAGE_SIZE = exports.BULK_DELETE_MAX_RETRIES = exports.BULK_DELETE_PAGE_PAUSE_MS = exports.BULK_DELETE_MAX_IDS = exports.BULK_DELETE_GUARD_WINDOW_MS = exports.BULK_DELETE_GUARD_THRESHOLD = void 0;
 exports.getBulkDeleteGuardPath = getBulkDeleteGuardPath;
 exports.readDeleteGuardTimestamps = readDeleteGuardTimestamps;
 exports.recordDeletion = recordDeletion;
@@ -45,15 +45,10 @@ exports.parseCodeContextFlag = parseCodeContextFlag;
 exports.parseBatchIds = parseBatchIds;
 exports.isValidIsoDate = isValidIsoDate;
 exports.chunkIds = chunkIds;
-exports.isRateLimitError = isRateLimitError;
-exports.getRetryAfterMs = getRetryAfterMs;
-exports.sleep = sleep;
 exports.bulkDeleteWithRetry = bulkDeleteWithRetry;
 exports.runBulkDeletePaged = runBulkDeletePaged;
 exports.collectAllMemoryIds = collectAllMemoryIds;
-exports.isServiceUnavailableError = isServiceUnavailableError;
 exports.isRetryableCreateError = isRetryableCreateError;
-exports.isQuotaError = isQuotaError;
 exports.parseJsonlCreateLine = parseJsonlCreateLine;
 exports.resolveCreateConcurrency = resolveCreateConcurrency;
 exports.batchCreateWithRetry = batchCreateWithRetry;
@@ -74,6 +69,12 @@ const chalk_1 = __importDefault(require("chalk"));
 const api_client_1 = require("../lib/api-client");
 const config_1 = require("../lib/config");
 const errors_1 = require("../lib/errors");
+const retry_1 = require("../lib/retry");
+Object.defineProperty(exports, "isRateLimitError", { enumerable: true, get: function () { return retry_1.isRateLimitError; } });
+Object.defineProperty(exports, "isServiceUnavailableError", { enumerable: true, get: function () { return retry_1.isServiceUnavailableError; } });
+Object.defineProperty(exports, "isQuotaError", { enumerable: true, get: function () { return retry_1.isQuotaError; } });
+Object.defineProperty(exports, "getRetryAfterMs", { enumerable: true, get: function () { return retry_1.getRetryAfterMs; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return retry_1.sleep; } });
 const formatters_1 = require("../lib/formatters");
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const spinner_1 = require("../lib/spinner");
@@ -270,11 +271,11 @@ async function resolveShortIds(ids, opts = {}) {
         }
         else {
             // Resolve short ID
-            const listResponse = await (0, api_client_1.getSdk)().memories.listMemories({
+            const listResponse = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories({
                 limit: 10,
                 offset: 0,
                 idPrefix: id,
-            });
+            }));
             const matches = listResponse.data?.data || [];
             if (matches.length === 0) {
                 warn(`Warning: No memory found with prefix "${id}"`);
@@ -392,10 +393,10 @@ async function handleBatchMemoryGet(ids, options) {
         }
         spinner.text = `Fetching ${resolvedIds.length} memories...`;
         const batchDetail = options.detail || 'minimal';
-        const response = await (0, api_client_1.getSdk)().memories.getMemoriesBatch({
+        const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoriesBatch({
             ids: resolvedIds,
             detail: batchDetail,
-        });
+        }));
         const result = response.data;
         if (result && result.meta && result.meta.missing && result.meta.missing.length > 0) {
             spinner.warn(`Found ${result.meta.found} of ${result.meta.requested} memories`);
@@ -506,42 +507,46 @@ function chunkIds(ids, size = exports.BULK_DELETE_MAX_IDS) {
     }
     return chunks;
 }
-/** True when an error is an HTTP 429 (rate limited). */
-function isRateLimitError(error) {
-    const status = error?.status ?? error?.statusCode ?? error?.response?.status;
-    return status === 429;
+// ── Single-shot retry wiring (PO CLI-latency directive, item 3) ──────────────
+// These thin wrappers apply the shared withSingleShotRetry helper at the plain
+// single-request SDK call sites. The idempotency flag is passed PER CALL SITE —
+// that is the crux of the retry matrix, and it cannot be inferred centrally
+// because the same SDK method (createMemory) serves BOTH single create (retry)
+// and the batch --stdin-jsonl path (already retries via batchCreateWithRetry).
+// Wrapping per single-shot site is therefore the correct, non-double-wrapping
+// chokepoint; the batch helpers are left untouched.
+/** STDERR-only retry notice. Never touches stdout, so `--format json` stays pure. */
+function emitRetryNotice(info) {
+    const reason = info.status === 429 ? 'rate limited' : `transient error ${info.status ?? ''}`.trim();
+    console.error(chalk_1.default.dim(`⏳ ${reason}; retry ${info.attempt}/${info.maxRetries} in ${(info.waitMs / 1000).toFixed(1)}s`));
 }
 /**
- * Extract the server's Retry-After hint in milliseconds, or null if absent.
- * The API surfaces it as a body field (`retryAfter`, seconds) on 429s
- * (see lib/errors.ts) and may also send a Retry-After header; we honor both.
+ * Wrap an idempotent single-shot read (GET search/get/list/recall) or a
+ * naturally idempotent write (DELETE — deleting an already-deleted id is a
+ * no-op). Retries 429 and transient 5xx (502/503/504/408). Do NOT use this for
+ * named-memory PUT: it is a version bump that is only idempotent when
+ * expectedHeadId is supplied, and the CLI/SDK never supply it — use retryWrite.
  */
-function getRetryAfterMs(error) {
-    const data = error?.data ?? error?.response?.data ?? {};
-    const secs = data?.retryAfter ?? data?.retry_after;
-    if (typeof secs === 'number' && Number.isFinite(secs) && secs >= 0) {
-        return Math.round(secs * 1000);
-    }
-    const headers = error?.headers;
-    let headerVal;
-    if (headers) {
-        if (typeof headers.get === 'function') {
-            headerVal = headers.get('retry-after') ?? headers.get('Retry-After');
-        }
-        else {
-            headerVal = headers['retry-after'] ?? headers['Retry-After'];
-        }
-    }
-    if (headerVal) {
-        const n = parseInt(String(headerVal), 10);
-        if (Number.isFinite(n) && n >= 0)
-            return n * 1000;
-    }
-    return null;
+function retryRead(fn) {
+    return (0, retry_1.withSingleShotRetry)(fn, {
+        idempotent: true,
+        sleep: retry_1.sleep,
+        maxRetries: retry_1.SINGLE_SHOT_MAX_RETRIES,
+        onRetry: emitRetryNotice,
+    });
 }
-/** Promise-based sleep. Extracted so tests can inject a no-op/spy. */
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Wrap a non-idempotent single-shot write (plain POST create, non-CAS update).
+ * Retries ONLY 429 (server rejected before processing — no duplicate risk);
+ * a transient 5xx is NOT auto-retried because the write may already have landed.
+ */
+function retryWrite(fn) {
+    return (0, retry_1.withSingleShotRetry)(fn, {
+        idempotent: false,
+        sleep: retry_1.sleep,
+        maxRetries: retry_1.SINGLE_SHOT_MAX_RETRIES,
+        onRetry: emitRetryNotice,
+    });
 }
 /**
  * Delete a single page, retrying on 429 up to `maxRetries` times. Honors the
@@ -556,8 +561,8 @@ async function bulkDeleteWithRetry(ids, deps) {
             return await deps.deleteFn(ids);
         }
         catch (error) {
-            if (isRateLimitError(error) && attempt < maxRetries) {
-                const waitMs = getRetryAfterMs(error) ?? defaultRetryMs * (attempt + 1);
+            if ((0, retry_1.isRateLimitError)(error) && attempt < maxRetries) {
+                const waitMs = (0, retry_1.getRetryAfterMs)(error) ?? defaultRetryMs * (attempt + 1);
                 deps.onRateLimited?.(waitMs);
                 await deps.sleep(waitMs);
                 attempt++;
@@ -737,7 +742,7 @@ async function handleBatchDelete(rawIds, options, mode) {
     try {
         const result = await runBulkDeletePaged(resolvedIds, {
             deleteFn: bulkDeleteViaSdk,
-            sleep,
+            sleep: retry_1.sleep,
             onPage: (i, total) => {
                 if (total > 1 && !jsonMode) {
                     spinner.text = `Deleting page ${i + 1} of ${total}...`;
@@ -841,19 +846,9 @@ exports.BATCH_CREATE_ALLOWED_KEYS = new Set([
     'outcome',
     'distill',
 ]);
-/** True when an error is an HTTP 503 (service unavailable — transient). */
-function isServiceUnavailableError(error) {
-    const status = error?.status ?? error?.statusCode ?? error?.response?.status;
-    return status === 503;
-}
 /** True when a create should be retried: 429 (rate limited) or 503 (transient). */
 function isRetryableCreateError(error) {
-    return isRateLimitError(error) || isServiceUnavailableError(error);
-}
-/** True when an error is an HTTP 402 (quota / payment required). */
-function isQuotaError(error) {
-    const status = error?.status ?? error?.statusCode ?? error?.response?.status;
-    return status === 402;
+    return (0, retry_1.isRateLimitError)(error) || (0, retry_1.isServiceUnavailableError)(error);
 }
 /**
  * Parse and validate one JSONL line into a createMemory body.
@@ -990,10 +985,10 @@ async function batchCreateWithRetry(data, deps) {
             return await deps.createFn(data);
         }
         catch (error) {
-            if (isQuotaError(error))
+            if ((0, retry_1.isQuotaError)(error))
                 throw error;
             if (isRetryableCreateError(error) && attempt < maxRetries) {
-                const waitMs = getRetryAfterMs(error) ?? defaultRetryMs * (attempt + 1);
+                const waitMs = (0, retry_1.getRetryAfterMs)(error) ?? defaultRetryMs * (attempt + 1);
                 deps.onRateLimited?.(waitMs);
                 await deps.sleep(waitMs);
                 attempt++;
@@ -1087,7 +1082,7 @@ async function runBatchCreate(items, deps) {
                 }
                 catch (error) {
                     summary.failed++;
-                    if (isQuotaError(error)) {
+                    if ((0, retry_1.isQuotaError)(error)) {
                         // Quota exhausted — pointless to keep hammering. Stop pulling new
                         // lines; in-flight workers finish, remaining lines are not-attempted.
                         stopped = true;
@@ -1253,7 +1248,7 @@ async function handleStreamingCreate(maxStdinBytes = exports.BATCH_CREATE_MAX_ST
     const claudeSessionId = claudeSession?.sessionId || undefined;
     const summary = await runBatchCreate(items, {
         createFn: (data) => createOneViaSdk(claudeSessionId ? { ...data, claudeSessionId } : data),
-        sleep,
+        sleep: retry_1.sleep,
         concurrency,
         onResult: (r) => {
             // Pure JSONL on stdout — the ONLY stdout write on this path. A broken pipe
@@ -1319,7 +1314,7 @@ function registerMemoriesCommands(program) {
             // Named memories filter — fetch and filter client-side
             if (options.named) {
                 const spinner = (0, spinner_1.createSpinner)('Fetching named memories...', options.format).start();
-                const namedResponse = await (0, api_client_1.getSdk)().memories.listMemories({ limit: 100, offset: 0 });
+                const namedResponse = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories({ limit: 100, offset: 0 }));
                 const namedMemories = (namedResponse.data?.data || []).filter((m) => m.name);
                 spinner.succeed(`Found ${namedMemories.length} named memories`);
                 if (options.format === 'table' || !options.format) {
@@ -1420,7 +1415,7 @@ function registerMemoriesCommands(program) {
                     .filter((t) => t.length > 0)
                     .join(',');
             }
-            const response = await (0, api_client_1.getSdk)().memories.listMemories(listParams);
+            const response = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories(listParams));
             const result = response.data;
             spinner.succeed(`Found ${result?.data?.length || 0} memories`);
             // Format for table display
@@ -1479,9 +1474,9 @@ function registerMemoriesCommands(program) {
             // Named memory lookup — short-circuits the entire ID-based flow
             if (options.name) {
                 const spinner = (0, spinner_1.createSpinner)('Fetching named memory...', options.format).start();
-                const response = await (0, api_client_1.getSdk)().memories.getMemoryByName(options.name, {
+                const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryByName(options.name, {
                     detail: options.detail || 'standard',
-                });
+                }));
                 const memory = response.data?.data;
                 if (!memory) {
                     spinner.fail(`No memory found with name '${options.name}'`);
@@ -1521,9 +1516,9 @@ function registerMemoriesCommands(program) {
                 if (isNamedKey) {
                     const spinner = (0, spinner_1.createSpinner)('Fetching named memory...', options.format).start();
                     try {
-                        const response = await (0, api_client_1.getSdk)().memories.getMemoryByName(singleId, {
+                        const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryByName(singleId, {
                             detail: options.detail || 'standard',
-                        });
+                        }));
                         const memory = response.data?.data;
                         if (!memory) {
                             spinner.fail(`No memory found with name '${singleId}'`);
@@ -1552,11 +1547,11 @@ function registerMemoriesCommands(program) {
                 let resolvedMemory = null;
                 if (isShortId) {
                     const spinner = (0, spinner_1.createSpinner)('Searching for matching memory...', options.format).start();
-                    const listResponse = await (0, api_client_1.getSdk)().memories.listMemories({
+                    const listResponse = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories({
                         limit: 10,
                         offset: 0,
                         idPrefix: singleId,
-                    });
+                    }));
                     const matches = listResponse.data?.data || [];
                     if (matches.length === 0) {
                         spinner.fail(`No memory found with ID prefix: ${singleId}`);
@@ -1597,9 +1592,9 @@ function registerMemoriesCommands(program) {
                         });
                     }
                     else {
-                        const response = await (0, api_client_1.getSdk)().memories.getMemoryById(memoryId, {
+                        const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryById(memoryId, {
                             detail,
-                        });
+                        }));
                         const memory = response.data?.data;
                         printMemoryWithDetail(memory, options.format, {
                             includeVectors: !!options.includeVectors,
@@ -1789,7 +1784,12 @@ function registerMemoriesCommands(program) {
             let response;
             let upserted = false;
             try {
-                response = await (0, api_client_1.getSdk)().memories.createMemory(memoryData);
+                // Single create is non-idempotent → retryWrite (429-only: a rejected
+                // 429 never reached processing, so a retry cannot duplicate the create;
+                // a transient 5xx is NOT retried here to avoid a duplicate). A 409
+                // (named already exists) is not retryable and falls through to the
+                // auto-upsert branch below unchanged.
+                response = await retryWrite(() => (0, api_client_1.getSdk)().memories.createMemory(memoryData));
             }
             catch (createError) {
                 // 409 = named memory already exists → auto-upsert via updateNamedMemory
@@ -1811,7 +1811,15 @@ function registerMemoriesCommands(program) {
                     // intentionally NOT forwarded here: it is applied uniformly for both the
                     // create and upsert paths by the createMemoryRelationship call below, so
                     // forwarding it in the body too would create a duplicate SUPERSEDES edge.
-                    response = await (0, api_client_1.getSdk)().memories.updateNamedMemory(memoryData.name, {
+                    // Named update is NOT idempotent on this path: the CLI/SDK never
+                    // supply expectedHeadId, so PUT /named/:name does an UNCONDITIONAL
+                    // version bump (buildNamedVersionBumpCypher). retryWrite → 429-only:
+                    // the named-write gate acquires the permit BEFORE this.write, so a
+                    // 429 is pre-write and safe to retry; a 5xx is ambiguous (the bump
+                    // may already have committed — e.g. Kong 504 after Neo4j commits)
+                    // and MUST NOT be retried, or it silently creates a second identical
+                    // version (memory-history corruption).
+                    response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateNamedMemory(memoryData.name, {
                         content: memoryData.content,
                         ...(options.memoryType && { memoryType: options.memoryType }),
                         ...(memoryData.topics && { topics: memoryData.topics }),
@@ -1825,7 +1833,7 @@ function registerMemoriesCommands(program) {
                             options.conversationId.toUpperCase() !== 'NEW' && {
                             conversationId: options.conversationId,
                         }),
-                    });
+                    }));
                     upserted = true;
                 }
                 else {
@@ -1858,12 +1866,12 @@ function registerMemoriesCommands(program) {
             if (options.supersedes && memory?.id) {
                 const relSpinner = (0, spinner_1.createSpinner)('Creating SUPERSEDES relationship...', options.format).start();
                 try {
-                    await (0, api_client_1.getSdk)().memories.createMemoryRelationship(memory.id, {
+                    await retryWrite(() => (0, api_client_1.getSdk)().memories.createMemoryRelationship(memory.id, {
                         targetMemoryId: options.supersedes,
                         type: 'SUPERSEDES',
                         confidence: 1.0,
                         reason: 'Created via --supersedes flag',
-                    });
+                    }));
                     relSpinner.succeed(`Relationship created: ${memory.id.substring(0, 8)}... SUPERSEDES ${options.supersedes.substring(0, 8)}...`);
                 }
                 catch (relError) {
@@ -1928,7 +1936,7 @@ function registerMemoriesCommands(program) {
                 }
                 updates.name = options.assignName;
                 const spinner = (0, spinner_1.createSpinner)('Assigning name...', options.format).start();
-                const response = await (0, api_client_1.getSdk)().memories.updateMemory(id, updates);
+                const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateMemory(id, updates));
                 const memory = response.data?.data;
                 spinner.succeed(`Memory ${id} named '${options.assignName}'`);
                 (0, formatters_1.printOutput)(memory, options.format);
@@ -1939,15 +1947,15 @@ function registerMemoriesCommands(program) {
                 if (options.name) {
                     // Look up current memory by name, then update its name
                     const spinner = (0, spinner_1.createSpinner)('Renaming...', options.format).start();
-                    const getResponse = await (0, api_client_1.getSdk)().memories.getMemoryByName(options.name);
+                    const getResponse = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryByName(options.name));
                     const currentMemory = getResponse.data?.data;
                     if (!currentMemory?.id) {
                         spinner.fail(`Named memory '${options.name}' not found`);
                         return;
                     }
-                    const response = await (0, api_client_1.getSdk)().memories.updateMemory(currentMemory.id, {
+                    const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateMemory(currentMemory.id, {
                         name: options.rename,
-                    });
+                    }));
                     const memory = response.data?.data;
                     spinner.succeed(`Named memory '${options.name}' renamed to '${options.rename}'`);
                     (0, formatters_1.printOutput)(memory, options.format);
@@ -1956,7 +1964,7 @@ function registerMemoriesCommands(program) {
                 if (id) {
                     updates.name = options.rename;
                     const spinner = (0, spinner_1.createSpinner)('Renaming...', options.format).start();
-                    const response = await (0, api_client_1.getSdk)().memories.updateMemory(id, updates);
+                    const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateMemory(id, updates));
                     const memory = response.data?.data;
                     spinner.succeed(`Memory ${id} renamed to '${options.rename}'`);
                     (0, formatters_1.printOutput)(memory, options.format);
@@ -1972,7 +1980,13 @@ function registerMemoriesCommands(program) {
             // Named memory update — creates new version
             if (options.name) {
                 const spinner = (0, spinner_1.createSpinner)('Creating new version...', options.format).start();
-                const response = await (0, api_client_1.getSdk)().memories.updateNamedMemory(options.name, updates);
+                // Named update is NOT idempotent without expectedHeadId (which the
+                // CLI/SDK never supply): PUT /named/:name unconditionally bumps the
+                // version. retryWrite → 429-only: the gate takes the permit before the
+                // write, so a 429 is pre-write and safe to retry; a 5xx is ambiguous
+                // (the bump may already have committed) and MUST NOT be retried, or it
+                // creates a second identical version (silent history corruption).
+                const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateNamedMemory(options.name, updates));
                 const memory = response.data?.data;
                 const meta = response.data?.meta;
                 spinner.succeed(`Named memory '${options.name}' updated to v${meta?.version}`);
@@ -1983,7 +1997,7 @@ function registerMemoriesCommands(program) {
                 return;
             }
             const spinner = (0, spinner_1.createSpinner)('Updating memory...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.updateMemory(id, updates);
+            const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.updateMemory(id, updates));
             const memory = response.data?.data;
             spinner.succeed(`Memory ${id} updated successfully`);
             (0, formatters_1.printOutput)(memory, options.format);
@@ -2004,7 +2018,7 @@ function registerMemoriesCommands(program) {
         .action(async (name, options) => {
         try {
             const spinner = (0, spinner_1.createSpinner)('Fetching version history...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.getNamedMemoryHistory(name);
+            const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getNamedMemoryHistory(name));
             const data = response.data;
             if (!data?.versions?.length) {
                 spinner.fail(`No memory found with name '${name}'`);
@@ -2205,7 +2219,9 @@ function registerMemoriesCommands(program) {
                 }
             }
             const spinner = (0, spinner_1.createSpinner)('Deleting memory...', 'table').start();
-            await (0, api_client_1.getSdk)().memories.deleteMemory(id);
+            // DELETE is idempotent (deleting an already-deleted id is a no-op), so a
+            // transient 5xx is retry-safe as well as a 429.
+            await retryRead(() => (0, api_client_1.getSdk)().memories.deleteMemory(id));
             // Record this deletion in the cross-process guard file so the next
             // invocation's threshold check reflects it.
             if (isNonInteractive) {
@@ -2426,7 +2442,7 @@ function registerMemoriesCommands(program) {
                 searchRequest.order = options.order;
             }
             // Use GET endpoint for better performance (Issue #79)
-            const response = await (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest);
+            const response = await retryRead(() => (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest));
             const searchData = response.data;
             // Normalize: API may return flat objects or {memory, score} wrappers.
             // Ensure consistent {memory, score, matchedVia} shape for display code.
@@ -2844,19 +2860,19 @@ async function handleMemoryDiscovery(memoryId, options) {
         const sdk = (0, api_client_1.getSdk)();
         if (options.similar) {
             discoveryType = 'similar';
-            const response = await sdk.memories.getSimilarMemories(memoryId, { limit: options.limit });
+            const response = await retryRead(() => sdk.memories.getSimilarMemories(memoryId, { limit: options.limit }));
             result = response.data;
         }
         else if (options.conversation) {
             discoveryType = 'conversation';
-            const response = await sdk.memories.getConversationMemories(memoryId, {
+            const response = await retryRead(() => sdk.memories.getConversationMemories(memoryId, {
                 limit: options.limit,
-            });
+            }));
             result = response.data;
         }
         else if (options.related) {
             discoveryType = 'related';
-            const response = await sdk.memories.getRelatedMemories(memoryId, { limit: options.limit });
+            const response = await retryRead(() => sdk.memories.getRelatedMemories(memoryId, { limit: options.limit }));
             result = response.data;
         }
         else {
@@ -2957,9 +2973,9 @@ function registerMemoryRelationshipCommands(memories) {
                 return;
             }
             const spinner = (0, spinner_1.createSpinner)('Fetching relationships...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.getMemoryRelationships(id, {
+            const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryRelationships(id, {
                 direction: options.direction,
-            });
+            }));
             const result = response.data;
             spinner.succeed(`Found ${result?.data?.length || 0} relationships`);
             if (options.format === 'table' || !options.format) {
@@ -3065,7 +3081,7 @@ function registerMemoryRelationshipCommands(memories) {
                 };
             }
             const spinner = (0, spinner_1.createSpinner)('Creating relationship...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.createMemoryRelationship(id, relationshipData);
+            const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.createMemoryRelationship(id, relationshipData));
             const relationship = response.data?.data;
             spinner.succeed(`Relationship created: ${id} ${relationship?.type} ${relationshipData.targetMemoryId}`);
             (0, formatters_1.printOutput)(relationship, options.format);
@@ -3108,7 +3124,7 @@ function registerMemoryRelationshipCommands(memories) {
             }
             // Non-interactive without --force: auto-confirm single delete
             const spinner = (0, spinner_1.createSpinner)('Deleting relationship...', 'table').start();
-            await (0, api_client_1.getSdk)().memories.deleteMemoryRelationship(id, relationshipId);
+            await retryRead(() => (0, api_client_1.getSdk)().memories.deleteMemoryRelationship(id, relationshipId));
             spinner.succeed(`Relationship ${relationshipId} deleted successfully`);
         }
         catch (error) {
@@ -3136,7 +3152,7 @@ function registerMemoryTimelineCommand(memories) {
             const before = parseInt(options.before, 10);
             const after = parseInt(options.after, 10);
             const spinner = (0, spinner_1.createSpinner)('Fetching timeline context...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.getMemoryTimeline(id, { before, after });
+            const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryTimeline(id, { before, after }));
             const result = response.data;
             spinner.succeed('Timeline context retrieved');
             if (options.format === 'table' || !options.format) {
@@ -3199,12 +3215,14 @@ function registerDetectRelationshipsCommand(memories) {
             const spinner = (0, spinner_1.createSpinner)(options.autoCreate
                 ? 'Detecting and creating relationships...'
                 : 'Detecting relationships...', options.format).start();
-            const response = await (0, api_client_1.getSdk)().memories.detectMemoryRelationships(id, {
+            // detect with --auto-create writes relationship edges, so it is
+            // non-idempotent → retryWrite (429-only) to avoid duplicate edges on 5xx.
+            const response = await retryWrite(() => (0, api_client_1.getSdk)().memories.detectMemoryRelationships(id, {
                 body: {
                     autoCreate: options.autoCreate || false,
                     minConfidence,
                 },
-            });
+            }));
             const result = response.data;
             const suggestions = result?.data || [];
             spinner.succeed(`Found ${suggestions.length} potential relationships`);
@@ -3344,7 +3362,7 @@ function registerDigestCommand(memories) {
                 sdk.config.timeoutMs = RECALL_MAX_MS;
             let response;
             try {
-                response = await sdk.memories.generateMemoryDigest(body);
+                response = await retryRead(() => sdk.memories.generateMemoryDigest(body));
             }
             finally {
                 if (sdk.config)
@@ -3433,7 +3451,7 @@ function registerStatusCommand(memories) {
                 sdk.config.timeoutMs = 180000;
             let response;
             try {
-                response = await sdk.memories.generateMemoryDigest(body);
+                response = await retryRead(() => sdk.memories.generateMemoryDigest(body));
             }
             finally {
                 if (sdk.config)
@@ -3579,7 +3597,7 @@ function registerRecapCommand(memories) {
                 };
                 if (excludeTopicsParam)
                     searchRequest.excludeTopics = excludeTopicsParam;
-                const response = await (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest);
+                const response = await retryRead(() => (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest));
                 // Normalize: API may return flat objects or {memory, score} wrappers.
                 results = (response.data?.data || []).map((r) => r.memory ? r : { memory: r, score: r.score, matchedVia: r.matchedVia });
             }
@@ -3595,7 +3613,7 @@ function registerRecapCommand(memories) {
                 };
                 if (excludeTopicsParam)
                     listRequest.excludeTopics = excludeTopicsParam;
-                const response = await (0, api_client_1.getSdk)().memories.listMemories(listRequest);
+                const response = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories(listRequest));
                 // Wrap in search-result shape expected by groupByConversation / displayRecap
                 results = (response.data?.data || []).map((m) => ({ memory: m }));
             }
@@ -3833,7 +3851,7 @@ function registerBuildContextCommand(memories) {
                 body.files = options.files;
             }
             const sdk = (0, api_client_1.getSdk)();
-            const response = await sdk.memories.buildContext(body);
+            const response = await retryRead(() => sdk.memories.buildContext(body));
             const data = response?.data || response;
             if (!data) {
                 spinner.fail('No response data received');