@promptbook/node 0.111.0-7 → 0.112.0-12

package/esm/apps/agents-server/src/utils/retryWithBackoff.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Callback invoked before one retry wait.
+ *
+ * @private utility for Agents Server runtime retries
+ */
+export type RetryWithBackoffAttempt = {
+    /**
+     * Number of failed attempts completed so far (1-based).
+     */
+    readonly attempt: number;
+    /**
+     * Configured number of retries after the first attempt.
+     */
+    readonly retries: number;
+    /**
+     * Delay scheduled before the next attempt.
+     */
+    readonly delayMs: number;
+    /**
+     * Error from the attempt that just failed.
+     */
+    readonly error: unknown;
+};
+/**
+ * Result metadata returned from a retry operation.
+ *
+ * @private utility for Agents Server runtime retries
+ */
+export type RetryWithBackoffResult<TValue> = {
+    /**
+     * Value returned from the successful attempt.
+     */
+    readonly value: TValue;
+    /**
+     * Number of attempts used (first try + retries).
+     */
+    readonly attempts: number;
+    /**
+     * Total elapsed time in milliseconds across attempts and waits.
+     */
+    readonly durationMs: number;
+};
+/**
+ * Configurable options for retrying one asynchronous operation with backoff.
+ *
+ * @private utility for Agents Server runtime retries
+ */
+export type RetryWithBackoffOptions = {
+    /**
+     * Number of retries after the initial attempt.
+     */
+    readonly retries: number;
+    /**
+     * Initial backoff delay before retry #1.
+     */
+    readonly initialDelayMs: number;
+    /**
+     * Upper bound for one backoff delay.
+     */
+    readonly maxDelayMs: number;
+    /**
+     * Multiplier used for exponential growth between retry delays.
+     */
+    readonly backoffFactor: number;
+    /**
+     * Randomized extra delay ratio relative to the exponential delay.
+     */
+    readonly jitterRatio: number;
+    /**
+     * Optional cancellation signal.
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Optional predicate deciding if the thrown error can be retried.
+     */
+    readonly shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /**
+     * Optional callback called before waiting for one retry.
+     */
+    readonly onRetry?: (attempt: RetryWithBackoffAttempt) => void;
+    /**
+     * Random provider used for jitter; defaults to `Math.random`.
+     */
+    readonly random?: () => number;
+    /**
+     * Sleep implementation used during backoff; defaults to an abort-aware timeout.
+     */
+    readonly sleep?: (delayMs: number, signal?: AbortSignal) => Promise<void>;
+};
+/**
+ * Retries one async operation with exponential backoff and jitter.
+ *
+ * @private utility for Agents Server runtime retries
+ */
+export declare function retryWithBackoff<TValue>(operation: (attempt: number) => Promise<TValue>, options: RetryWithBackoffOptions): Promise<RetryWithBackoffResult<TValue>>;

package/esm/apps/agents-server/src/utils/runBrowserArtifactStorage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Logical public directory marker used in `run_browser` payload paths.
+ *
+ * This value is kept stable for UI parsing and `/api/browser-artifacts/*` URL mapping.
+ */
+export declare const RUN_BROWSER_ARTIFACT_PUBLIC_DIRECTORY = ".playwright-cli";
+/**
+ * Whitelist pattern for browser artifact filenames produced by `run_browser`.
+ */
+export declare const RUN_BROWSER_ARTIFACT_FILENAME_PATTERN: RegExp;
+/**
+ * Resolves writable filesystem directory used for artifact persistence.
+ */
+export declare function resolveRunBrowserArtifactStorageDirectory(): string;
+/**
+ * Resolves absolute filesystem path of one artifact filename.
+ */
+export declare function resolveRunBrowserArtifactFilesystemPath(artifactFilename: string): string;
+/**
+ * Resolves payload path of one artifact filename used by replay renderers.
+ */
+export declare function resolveRunBrowserArtifactPublicPath(artifactFilename: string): string;
+/**
+ * Validates whether one filename belongs to the supported browser artifact set.
+ */
+export declare function isRunBrowserArtifactFilename(artifactFilename: string): boolean;