ag-common 0.0.911 → 0.0.913

package/dist/api/helpers/index.d.ts

@@ -1,12 +1,10 @@
 export * from "./acm";
-export * from "./ai";
 export * from "./api";
 export * from "./apigw";
 export * from "./aws";
 export * from "./cosmos";
 export * from "./dynamo";
 export * from "./enforceDynamoProvisionCap";
-export * from "./google";
 export * from "./retryOnError";
 export * from "./s3";
 export * from "./ses";

package/dist/api/helpers/index.js

@@ -15,14 +15,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./acm"), exports);
-__exportStar(require("./ai"), exports);
 __exportStar(require("./api"), exports);
 __exportStar(require("./apigw"), exports);
 __exportStar(require("./aws"), exports);
 __exportStar(require("./cosmos"), exports);
 __exportStar(require("./dynamo"), exports);
 __exportStar(require("./enforceDynamoProvisionCap"), exports);
-__exportStar(require("./google"), exports);
 __exportStar(require("./retryOnError"), exports);
 __exportStar(require("./s3"), exports);
 __exportStar(require("./ses"), exports);

package/dist/api/helpers/retryOnError.d.ts

@@ -2,7 +2,25 @@ export declare const overloadedMessages: string[];
 export declare const retryableErrorMessages: string[];
 export declare const isOverloadedApiKeyError: (error: unknown) => boolean;
 export declare const isRetryableApiError: (error: unknown) => boolean;
+export type RetryOnErrorOptions = {
+    /** Number of retries after the initial attempt. Defaults to 1. */
+    retries?: number;
+    /** Delay between attempts in ms. Defaults to 2000. */
+    errorDelay?: number;
+    /** Predicate deciding whether a failure is worth retrying. */
+    errorCheck?: (error: unknown) => boolean;
+    /** AbortSignal cancelling the backoff sleep and further attempts. */
+    signal?: AbortSignal;
+    /**
+     * Delay before each attempt after the first, in ms. It composes with
+     * errorDelay: the attempt waits for initialDelayMs plus errorDelay.
+     * Defaults to 0 (no pacing).
+     */
+    initialDelayMs?: number;
+    /** Sleep implementation, overridable in tests. */
+    sleepFn?: (ms: number) => Promise<unknown>;
+};
 export declare function retryOnError<T>(
 /** so we can log retries with useful info */
-debugIdent: string, fn: () => Promise<T>, retries?: number, errorDelay?: number, errorCheck?: (error: unknown) => boolean, signal?: AbortSignal): Promise<T>;
+debugIdent: string, fn: () => Promise<T>, retriesOrOptions?: number | RetryOnErrorOptions, errorDelay?: number, errorCheck?: (error: unknown) => boolean, signal?: AbortSignal): Promise<T>;
 export declare const sleep: (ms: number) => Promise<unknown>;

package/dist/api/helpers/retryOnError.js

@@ -70,19 +70,51 @@ const awaitWithSignal = async (promise, signal) => {
     });
     return Promise.race([promise, abort]);
 };
+const normalizeRetryOnErrorOptions = (retriesOrOptions, errorDelay, errorCheck, signal) => ({
+    retries: typeof retriesOrOptions === "number" ? retriesOrOptions : (retriesOrOptions?.retries ?? 1),
+    errorDelay: typeof retriesOrOptions === "number"
+        ? (errorDelay ?? 2000)
+        : (retriesOrOptions?.errorDelay ?? 2000),
+    errorCheck: typeof retriesOrOptions === "number"
+        ? (errorCheck ?? exports.isRetryableApiError)
+        : (retriesOrOptions?.errorCheck ?? exports.isRetryableApiError),
+    signal: typeof retriesOrOptions === "number" ? signal : (retriesOrOptions?.signal ?? signal),
+    initialDelayMs: typeof retriesOrOptions === "number" ? 0 : Math.max(0, retriesOrOptions?.initialDelayMs ?? 0),
+    sleepFn: typeof retriesOrOptions === "number" ? undefined : retriesOrOptions?.sleepFn,
+});
 async function retryOnError(
 /** so we can log retries with useful info */
-debugIdent, fn, retries = 1, errorDelay = 2000, errorCheck = exports.isRetryableApiError, signal) {
+debugIdent, fn, retriesOrOptions, errorDelay, errorCheck = exports.isRetryableApiError, signal) {
+    const options = normalizeRetryOnErrorOptions(retriesOrOptions, errorDelay, errorCheck, signal);
+    const sleepWithSignal = async (ms) => {
+        if (ms <= 0)
+            return;
+        if (options.sleepFn !== undefined) {
+            await options.sleepFn(ms);
+            return;
+        }
+        await awaitWithSignal((0, exports.sleep)(ms), options.signal);
+    };
+    // Pacing delay before attempts after the first: it spreads bursty fan-out
+    // (e.g. nightly jobs hitting a low free-tier quota) without changing the
+    // retry semantics for direct callers.
+    await sleepWithSignal(options.initialDelayMs);
     try {
         const result = await fn();
         return result;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        if (retries > 0 && errorCheck(error)) {
-            (0, log_1.info)(`Operation ${debugIdent} failed. Retrying after ${errorDelay}ms...`, message);
-            await awaitWithSignal((0, exports.sleep)(errorDelay), signal);
-            return retryOnError(debugIdent, fn, retries - 1, errorDelay, errorCheck, signal);
+        if (options.retries > 0 && options.errorCheck(error)) {
+            (0, log_1.info)(`Operation ${debugIdent} failed. Retrying after ${options.errorDelay}ms...`, message);
+            await sleepWithSignal(options.errorDelay);
+            return retryOnError(debugIdent, fn, {
+                retries: options.retries - 1,
+                errorDelay: options.errorDelay,
+                errorCheck: options.errorCheck,
+                signal: options.signal,
+                sleepFn: options.sleepFn,
+            });
         }
         throw error;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ag-common",
-  "version": "0.0.911",
+  "version": "0.0.913",
   "license": "ISC",
   "author": "admin@gec.dev",
   "repository": {

package/dist/api/helpers/ai/adapters/codex.d.ts

@@ -1,12 +0,0 @@
-import type { AIClientDependencies, AIEndpoint, AIModel, AIRequest, GenerationResult } from "../types";
-export type CodexAdapterConfig = {
-    endpoint: AIEndpoint;
-    dependencies?: AIClientDependencies;
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    maxPollIntervalMs?: number;
-};
-/** Validate and normalize the direct private LAN endpoint used by Codex. */
-export declare const normalizeCodexEndpoint: (endpoint: AIEndpoint) => AIEndpoint;
-export declare const generateCodex: (request: AIRequest, config: CodexAdapterConfig) => Promise<GenerationResult>;
-export declare const listCodexModels: (endpoint: AIEndpoint, dependencies?: AIClientDependencies) => Promise<AIModel[]>;