llm-cli-gateway 1.17.3 → 1.17.5

package/dist/request-helpers.js

@@ -1,33 +1,14 @@
-/**
- * Pure, side-effect-free helpers for request argument planning.
- * Zero I/O, zero dependencies on index-scoped collaborators.
- */
 import { existsSync, unlinkSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
 import { join, isAbsolute } from "path";
 import { randomUUID } from "crypto";
 import { z } from "zod/v3";
-/** Prefix for gateway-generated session IDs. Enforces provenance structurally. */
 export const GATEWAY_SESSION_PREFIX = "gw-";
-/**
- * Validate that a user-provided sessionId doesn't use the reserved gateway prefix.
- * Throws if the ID starts with "gw-" — this namespace is reserved for gateway-generated IDs.
- */
 export function validateSessionId(sessionId) {
     if (sessionId.startsWith(GATEWAY_SESSION_PREFIX)) {
         throw new Error(`Session ID "${sessionId}" uses reserved prefix "${GATEWAY_SESSION_PREFIX}". Gateway-generated session IDs cannot be used for --resume.`);
     }
 }
-/**
- * Pure function: determine --resume args and session provenance from request flags.
- * Does NOT perform any session I/O — callers handle create/update separately.
- */
-/**
- * Reject CLI arg values that start with "-" to prevent argument injection.
- * spawn() doesn't invoke a shell so there's no shell injection, but a value
- * like "--dangerously-skip-permissions" passed as a tool name would be
- * interpreted as a flag by the child CLI.
- */
 export function sanitizeCliArgValues(values, fieldName) {
     for (const v of values) {
         if (v.startsWith("-")) {
@@ -70,12 +51,6 @@ export function resolveCodexSessionArgs(opts) {
     }
     return { mode: "new" };
 }
-/**
- * Grok-specific resume args. Grok accepts `--resume <id>` to resume a named session,
- * and `--continue` to resume the most recent session for the current working directory.
- * Unlike `resolveSessionResumeArgs`, "resume latest" maps to `--continue` (not `--resume latest`)
- * because Grok would interpret a literal "latest" as a session ID.
- */
 export function resolveGrokSessionArgs(opts) {
     if (opts.createNewSession) {
         return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
@@ -97,16 +72,6 @@ export function resolveGrokSessionArgs(opts) {
     }
     return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
 }
-/**
- * Mistral Vibe-specific resume args.
- *
- * Current Vibe defaults session logging on; older configs can explicitly set
- * `[session_logging] enabled = false`. The doctor checks that toggle before
- * callers rely on session continuity; this pure helper just emits the args.
- *
- * The args shape mirrors Grok (`--continue` for latest, `--resume <id>` for a
- * specific session) because Vibe exposes the same surface for its session log.
- */
 export function resolveMistralSessionArgs(opts) {
     if (opts.createNewSession) {
         return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
@@ -128,13 +93,6 @@ export function resolveMistralSessionArgs(opts) {
     }
     return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
 }
-/**
- * Vibe-specific permission mode mapping. Vibe replaces Grok's `--always-approve`
- * with an `--agent <mode>` enum. When the caller does not set a permissionMode,
- * the gateway emits `--agent auto-approve` explicitly: omitting the flag would
- * let Vibe pick its own default which may not be auto-approve, surprising
- * programmatic callers.
- */
 export const MISTRAL_AGENT_MODES = [
     "default",
     "plan",
@@ -145,16 +103,6 @@ export const MISTRAL_AGENT_MODES = [
     "lean",
 ];
 export const MISTRAL_DEFAULT_AGENT_MODE = "auto-approve";
-/**
- * Pure helper that builds Vibe's argv and env.
- *
- * - Model is selected via `VIBE_ACTIVE_MODEL` env var (NOT a `--model` flag).
- * - Permission mode emits `--agent <mode>` (defaults to `auto-approve` when unset).
- * - Allowed tools emit `--enabled-tools <tool>` once per tool (allowlist only).
- * - Output format emits `--output <text|json|streaming>` (legacy gateway
- *   aliases `plain` and `stream-json` are normalized before spawn).
- * - Disallowed tools are accepted but ignored at the CLI boundary.
- */
 export function prepareMistralRequest(input) {
     const args = ["-p", input.prompt];
     const env = {};
@@ -166,12 +114,6 @@ export function prepareMistralRequest(input) {
     }
     const mode = input.permissionMode ?? MISTRAL_DEFAULT_AGENT_MODE;
     args.push("--agent", mode);
-    if (input.effort) {
-        args.push("--effort", input.effort);
-    }
-    if (input.reasoningEffort) {
-        args.push("--reasoning-effort", input.reasoningEffort);
-    }
     if (input.allowedTools && input.allowedTools.length > 0) {
         sanitizeCliArgValues(input.allowedTools, "allowedTools");
         for (const tool of input.allowedTools) {
@@ -208,14 +150,6 @@ function normalizeMistralOutputFormat(format) {
         return "streaming";
     return format;
 }
-//──────────────────────────────────────────────────────────────────────────────
-// U24: Permission / approval mode parity helpers
-//──────────────────────────────────────────────────────────────────────────────
-/**
- * Claude `--permission-mode` values. `default` is a no-op (no flag emitted) —
- * matches the CLI's behavior when the flag is absent, and avoids hard-coding an
- * undocumented literal.
- */
 export const CLAUDE_PERMISSION_MODES = [
     "default",
     "acceptEdits",
@@ -224,16 +158,6 @@ export const CLAUDE_PERMISSION_MODES = [
     "dontAsk",
     "bypassPermissions",
 ];
-/**
- * Resolve Claude's `--permission-mode` args.
- *
- * Precedence:
- *   1. If `permissionMode` is set, it wins. A warning is returned when
- *      `dangerouslySkipPermissions: true` is also set (legacy + new conflict).
- *   2. Else if `dangerouslySkipPermissions: true`, emit `--permission-mode
- *      bypassPermissions`.
- *   3. Else (or `permissionMode === "default"`) emit nothing.
- */
 export function resolveClaudePermissionFlags(input) {
     const { permissionMode, dangerouslySkipPermissions } = input;
     let warning;
@@ -252,33 +176,9 @@ export function resolveClaudePermissionFlags(input) {
     }
     return { args: [] };
 }
-/**
- * Gemini `--approval-mode` values. Preserves existing values (`default`,
- * `auto_edit`, `yolo`) and adds `plan` for parity with Claude's plan mode.
- */
 export const GEMINI_APPROVAL_MODES = ["default", "auto_edit", "yolo", "plan"];
-/**
- * Codex sandbox modes (for `--sandbox <mode>`).
- */
 export const CODEX_SANDBOX_MODES = ["read-only", "workspace-write", "danger-full-access"];
-/**
- * Deprecated Codex approval modes. Current Codex no longer exposes an
- * `--ask-for-approval` flag; the MCP input is temporarily retained so older
- * callers do not fail schema validation, but it emits no CLI argv.
- */
 export const CODEX_ASK_FOR_APPROVAL_MODES = ["untrusted", "on-request", "never"];
-/**
- * Resolve current Codex sandbox args from the modern params + legacy
- * `fullAuto` shorthand. Current Codex exposes `--sandbox`, but no longer
- * exposes `--ask-for-approval` or `--full-auto`.
- *
- * Precedence:
- *   1. Explicit `sandboxMode` emits `--sandbox <mode>`.
- *   2. Else if `fullAuto: true`, expand to `--sandbox workspace-write`.
- *   3. Deprecated `askForApproval` and `useLegacyFullAutoFlag` emit no argv
- *      and return warnings for callers to surface/log.
- *   4. Else emit nothing.
- */
 export function resolveCodexSandboxFlags(input) {
     const { sandboxMode, askForApproval, fullAuto, useLegacyFullAutoFlag } = input;
     const args = [];
@@ -300,17 +200,6 @@ export function resolveCodexSandboxFlags(input) {
     }
     return { args, warning: warnings.length > 0 ? warnings.join(" ") : undefined };
 }
-/**
- * Flags that `codex exec resume` rejects (the original session's policy is
- * inherited). Callers must drop these when building resume argv.
- *
- * Verified against `codex exec resume --help` (codex-cli 0.135.0):
- * `--sandbox`, `--add-dir`, `-C`, `--cd`, `--profile`, and `--search` are rejected.
- * Deprecated `--full-auto` / `--ask-for-approval` are kept here defensively so
- * legacy pre-filtered segments are stripped instead of reaching spawn.
- * `--output-schema` and `-c key=value` ARE accepted on resume and therefore are
- * NOT in this filter (Phase 4 slice α restored the previously-silent drop of those two).
- */
 export const CODEX_RESUME_FILTERED_FLAGS = new Set([
     "--full-auto",
     "--sandbox",
@@ -321,10 +210,6 @@ export const CODEX_RESUME_FILTERED_FLAGS = new Set([
     "--profile",
     "--search",
 ]);
-/**
- * Codex flags that take exactly one value (consumed together with the flag).
- * `--full-auto` and `--search` are bare booleans and intentionally absent.
- */
 const CODEX_RESUME_FILTERED_FLAGS_WITH_VALUE = new Set([
     "--sandbox",
     "--ask-for-approval",
@@ -333,13 +218,6 @@ const CODEX_RESUME_FILTERED_FLAGS_WITH_VALUE = new Set([
     "--cd",
     "--profile",
 ]);
-/**
- * Strip resume-incompatible flag/value pairs from a Codex argv segment.
- *
- * Bare flags (`--full-auto`, `--search`) drop without consuming a value.
- * Value-taking flags (`--sandbox`, `--ask-for-approval`, `--add-dir`, `-C`, `--cd`,
- * `--profile`) drop together with their immediately-following value.
- */
 export function filterCodexResumeFlags(args) {
     const out = [];
     for (let i = 0; i < args.length; i++) {
@@ -349,26 +227,12 @@ export function filterCodexResumeFlags(args) {
             continue;
         }
         if (CODEX_RESUME_FILTERED_FLAGS_WITH_VALUE.has(a)) {
-            i += 1; // also skip the value
+            i += 1;
         }
     }
     return out;
 }
-//──────────────────────────────────────────────────────────────────────────────
-// U25: Claude high-impact features
-//──────────────────────────────────────────────────────────────────────────────
-/**
- * Claude `--effort` enum values. Mirrors the model-side effort axis.
- */
 export const CLAUDE_EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
-/**
- * Standalone Zod object for U25's high-impact param subset. Enforces the
- * `systemPrompt` / `appendSystemPrompt` mutual-exclusion via `.refine(...)`.
- *
- * The MCP SDK's `server.tool` takes a raw shape (no top-level refine), so the
- * tool callback re-checks the constraint and returns an error response. This
- * exported schema is what tests use to verify Zod-level enforcement.
- */
 export const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA = z
     .object({
     agent: z.string().optional(),
@@ -385,12 +249,6 @@ export const CLAUDE_HIGH_IMPACT_PARAMS_SCHEMA = z
     message: "systemPrompt and appendSystemPrompt are mutually exclusive; use one or the other (not both).",
     path: ["appendSystemPrompt"],
 });
-/**
- * Minimal Anthropic agent-definition schema. Mirrors the shape expected by
- * Claude CLI's `--agents` inline JSON argument. We validate the *required*
- * keys (`description`, `prompt`) up-front so a malformed payload fails fast
- * with an actionable error instead of producing an opaque CLI exit.
- */
 export const CLAUDE_AGENT_DEFINITION_SCHEMA = z
     .object({
     description: z.string().min(1, "agent.description must be a non-empty string"),
@@ -399,13 +257,6 @@ export const CLAUDE_AGENT_DEFINITION_SCHEMA = z
     model: z.string().optional(),
 })
     .passthrough();
-/**
- * Validate an `agents` map against {@link CLAUDE_AGENT_DEFINITION_SCHEMA}.
- *
- * Returns `{ ok: true, value }` on success and `{ ok: false, agentKey, message }`
- * on the first failing entry. The caller is responsible for turning the failure
- * into a tool-level error response (e.g. via `createErrorResponse`).
- */
 export function validateClaudeAgentsMap(agents) {
     const validated = {};
     for (const [key, raw] of Object.entries(agents)) {
@@ -423,13 +274,6 @@ export function validateClaudeAgentsMap(agents) {
     }
     return { ok: true, value: validated };
 }
-/**
- * Emit Claude high-impact feature flags (U25) as a flat argv segment.
- *
- * Mutual-exclusion of `systemPrompt`/`appendSystemPrompt` is enforced upstream
- * at the Zod schema (`.refine(...)`); this helper does *not* re-check it, so
- * tests can exercise either flag in isolation.
- */
 export function prepareClaudeHighImpactFlags(input) {
     const args = [];
     if (input.agent) {
@@ -471,23 +315,20 @@ export function prepareClaudeHighImpactFlags(input) {
             args.push("--add-dir", dir);
         }
     }
+    if (input.noSessionPersistence) {
+        args.push("--no-session-persistence");
+    }
+    if (input.settingSources !== undefined) {
+        args.push("--setting-sources", input.settingSources);
+    }
+    if (input.settings !== undefined) {
+        args.push("--settings", input.settings);
+    }
+    if (input.tools && input.tools.length > 0) {
+        args.push("--tools", ...input.tools);
+    }
     return args;
 }
-//──────────────────────────────────────────────────────────────────────────────
-// U26: Codex high-impact features
-//──────────────────────────────────────────────────────────────────────────────
-/**
- * Zod schema for Codex `configOverrides` map.
- *
- * Hard requirements (argv-injection prevention):
- *   - Keys MUST match /^[a-zA-Z0-9._]+$/ (no whitespace, no equals, no flag-like prefixes).
- *   - Values MUST NOT contain CR or LF — newlines could be re-interpreted by the
- *     CLI's TOML parser as new keys.
- *
- * The CLI consumes overrides as `-c key=value`. We rely on `spawn(..., args)`
- * passing argv directly without a shell, so we forbid shape-breaking
- * characters rather than shell-escaping values.
- */
 export const CODEX_CONFIG_OVERRIDES_SCHEMA = z
     .record(z
     .string()
@@ -495,10 +336,6 @@ export const CODEX_CONFIG_OVERRIDES_SCHEMA = z
     message: "configOverrides values must not contain CR or LF characters",
 }))
     .optional();
-/**
- * Emit `-c key=value` pairs for each override. Caller MUST have validated the
- * map with {@link CODEX_CONFIG_OVERRIDES_SCHEMA} first.
- */
 export function emitCodexConfigOverrideArgs(overrides) {
     if (!overrides)
         return [];
@@ -526,15 +363,10 @@ export function prepareCodexOutputSchema(outputSchema) {
             unlinkSync(path);
         }
         catch {
-            // Best-effort: if the file is already gone, ignore.
         }
     };
     return { path, cleanup };
 }
-/**
- * Validate that every image path exists on disk. Returns the first missing
- * path on failure; `null` on success.
- */
 export function findMissingImagePath(images) {
     if (!images || images.length === 0)
         return null;
@@ -544,11 +376,6 @@ export function findMissingImagePath(images) {
     }
     return null;
 }
-/**
- * Zod schema for the U26 Codex high-impact feature subset. Used by the
- * `codex_request` / `codex_request_async` tool schemas to validate the new
- * params before they reach `prepareCodexRequest`.
- */
 export const CODEX_HIGH_IMPACT_PARAMS_SCHEMA = z.object({
     outputSchema: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
     search: z.boolean().optional(),
@@ -559,14 +386,6 @@ export const CODEX_HIGH_IMPACT_PARAMS_SCHEMA = z.object({
     ignoreUserConfig: z.boolean().optional(),
     ignoreRules: z.boolean().optional(),
 });
-/**
- * Build the U26 argv segment AND any required side-effect handles.
- *
- * IMPORTANT: When this function writes a temp file for `outputSchema`, the
- * returned `cleanup` function MUST be invoked by the caller (typically in a
- * `finally` block around the spawn). Failing to do so leaks `0o600` temp
- * files into `os.tmpdir()`.
- */
 export function prepareCodexHighImpactFlags(input) {
     const missingImagePath = findMissingImagePath(input.images);
     if (missingImagePath) {
@@ -621,20 +440,9 @@ export function prepareCodexForkRequest(input) {
     if (forkLast) {
         return { args: ["fork", "--last", prompt] };
     }
-    // sessionId path
     validateSessionId(sessionId);
     return { args: ["fork", sessionId, prompt] };
 }
-//──────────────────────────────────────────────────────────────────────────────
-// U27: Gemini high-impact features
-//──────────────────────────────────────────────────────────────────────────────
-/**
- * Prepend `@<abs-path>` tokens to a Gemini prompt so the CLI's attachment
- * resolver picks them up. Each path MUST be absolute and exist on disk.
- *
- * Returns the mutated prompt. Throws on validation failure so the caller can
- * convert to a `createErrorResponse`.
- */
 export function prependGeminiAttachments(prompt, attachments) {
     if (!attachments || attachments.length === 0)
         return prompt;
@@ -648,10 +456,6 @@ export function prependGeminiAttachments(prompt, attachments) {
         validateGeminiAttachmentTokenPath(p);
     }
     const tokens = attachments.map(p => `@${p}`).join(" ");
-    // Gemini attachments are prompt-level @path tokens rather than shell
-    // commands. Paths are absolute, existing, and token-safe before this join.
-    //
-    // codeql[js/shell-command-constructed-from-input]
     return `${tokens} ${prompt}`;
 }
 function validateGeminiAttachmentTokenPath(path) {
@@ -661,14 +465,6 @@ function validateGeminiAttachmentTokenPath(path) {
         }
     }
 }
-/**
- * Zod schema for the U27 Gemini high-impact feature subset. Used by the
- * `gemini_request` / `gemini_request_async` tool schemas to validate the new
- * params before they reach `prepareGeminiRequest`.
- *
- * `attachments` paths are validated to be absolute at the Zod layer; existence
- * is enforced at execution time via `prependGeminiAttachments`.
- */
 export const GEMINI_HIGH_IMPACT_PARAMS_SCHEMA = z.object({
     sandbox: z.boolean().optional(),
     policyFiles: z.array(z.string()).optional(),
@@ -679,15 +475,6 @@ export const GEMINI_HIGH_IMPACT_PARAMS_SCHEMA = z.object({
     }))
         .optional(),
 });
-/**
- * Emit Gemini U27 high-impact flags. Policy paths are existence-checked here
- * so a missing file fails fast with an actionable error rather than producing
- * an opaque CLI exit.
- *
- * Does NOT handle `attachments` — those are mutated into the prompt string
- * via {@link prependGeminiAttachments} BEFORE the `-p <prompt>` pair is
- * emitted, preserving the U21 `-p` ordering invariant.
- */
 export function prepareGeminiHighImpactFlags(input) {
     if (input.policyFiles) {
         for (const p of input.policyFiles) {
@@ -723,11 +510,6 @@ export function prepareGeminiHighImpactFlags(input) {
     }
     return { args, missingPolicyPath: null, missingPolicyField: null };
 }
-/**
- * Resolve Gemini session args. Gemini CLI 0.43 exposes `--resume` but not a
- * supported `--session-id` flag for fresh sessions, so new-session requests
- * intentionally emit no session flag and let the CLI create its own session.
- */
 export function resolveGeminiSessionPlan(opts) {
     if (opts.sessionId && !opts.createNewSession) {
         validateSessionId(opts.sessionId);

package/dist/resources.d.ts

@@ -26,31 +26,11 @@ export declare class ResourceProvider {
     private flightRecorder;
     private cacheAwareness;
     constructor(sessionManager: ISessionManager, performanceMetrics: PerformanceMetrics, flightRecorder?: FlightRecorderQuery, cacheAwareness?: CacheAwarenessConfig | null);
-    /** Read-only flight-recorder accessor for cache-state resource readers. */
     getFlightRecorderQuery(): FlightRecorderQuery;
-    /**
-     * cache_state://global — aggregates across the entire flight recorder.
-     * Optionally restrict to a recent window via `lastNHours`. Returns
-     * tokens/hashes/aggregates ONLY — no prompt text fields. The redaction is
-     * structural: the response shape (GlobalCacheStats) has no `prompt`,
-     * `response`, `system`, or `task` field by construction.
-     */
     readCacheStateGlobal(opts?: {
         lastNHours?: number;
     }): GlobalCacheStats;
-    /**
-     * cache_state://session/{sessionId} — per-session aggregates. Returns
-     * empty defaults when the session has no rows. Token/hash fields only.
-     *
-     * Slice 3: populates `ttlRemainingMs` by applying the configured TTL
-     * policy. Null for non-claude sessions or when the gateway has no
-     * cache-awareness config loaded (defaults to 5-min policy).
-     */
     readCacheStateSession(sessionId: string): SessionCacheStats;
-    /**
-     * cache_state://prefix/{hash} — per-stable-prefix-hash aggregates.
-     * Returns empty defaults for unknown hashes. Token/hash fields only.
-     */
     readCacheStateForPrefix(stablePrefixHash: string): PrefixCacheStats;
     listResources(): ResourceDefinition[];
     readResource(uri: string): Promise<ResourceContents | null>;

package/dist/resources.js

@@ -5,43 +5,18 @@ export class ResourceProvider {
     performanceMetrics;
     flightRecorder;
     cacheAwareness;
-    constructor(sessionManager, performanceMetrics, 
-    // Optional read access to the flight recorder. Used by cache-state
-    // resources (slice 2). Falls back to a stub returning [] when not
-    // injected so existing call sites continue to work without changes.
-    flightRecorder = { queryRequests: () => [] }, 
-    // Slice 3: optional cache-awareness config. When present, drives the
-    // TTL policy applied to ttlRemainingMs on session-scoped reads.
-    // When absent, the default Anthropic 5-min TTL applies (matches the
-    // 1.x default of `[cache_awareness].anthropic_ttl_seconds = 300`).
-    cacheAwareness = null) {
+    constructor(sessionManager, performanceMetrics, flightRecorder = { queryRequests: () => [] }, cacheAwareness = null) {
         this.sessionManager = sessionManager;
         this.performanceMetrics = performanceMetrics;
         this.flightRecorder = flightRecorder;
         this.cacheAwareness = cacheAwareness;
     }
-    /** Read-only flight-recorder accessor for cache-state resource readers. */
     getFlightRecorderQuery() {
         return this.flightRecorder;
     }
-    /**
-     * cache_state://global — aggregates across the entire flight recorder.
-     * Optionally restrict to a recent window via `lastNHours`. Returns
-     * tokens/hashes/aggregates ONLY — no prompt text fields. The redaction is
-     * structural: the response shape (GlobalCacheStats) has no `prompt`,
-     * `response`, `system`, or `task` field by construction.
-     */
     readCacheStateGlobal(opts = {}) {
         return computeGlobalCacheStats(this.flightRecorder, opts);
     }
-    /**
-     * cache_state://session/{sessionId} — per-session aggregates. Returns
-     * empty defaults when the session has no rows. Token/hash fields only.
-     *
-     * Slice 3: populates `ttlRemainingMs` by applying the configured TTL
-     * policy. Null for non-claude sessions or when the gateway has no
-     * cache-awareness config loaded (defaults to 5-min policy).
-     */
     readCacheStateSession(sessionId) {
         const stats = computeSessionCacheStats(this.flightRecorder, sessionId);
         const ttlSeconds = this.cacheAwareness?.anthropicTtlSeconds ?? 300;
@@ -50,14 +25,9 @@ export class ResourceProvider {
         });
         return stats;
     }
-    /**
-     * cache_state://prefix/{hash} — per-stable-prefix-hash aggregates.
-     * Returns empty defaults for unknown hashes. Token/hash fields only.
-     */
     readCacheStateForPrefix(stablePrefixHash) {
         return computePrefixCacheStats(this.flightRecorder, stablePrefixHash);
     }
-    // List all available resources
     listResources() {
         return [
             {
@@ -195,9 +165,7 @@ export class ResourceProvider {
             },
         ];
     }
-    // Read a specific resource by URI
     async readResource(uri) {
-        // Session resources
         if (uri === "sessions://all") {
             const sessions = await this.sessionManager.listSessions();
             return {
@@ -287,7 +255,6 @@ export class ResourceProvider {
                 }, null, 2),
             };
         }
-        // Model capability resources
         if (uri === "models://claude") {
             const cliInfo = getAvailableCliInfo();
             return {

package/dist/retry.d.ts

@@ -1,23 +1,9 @@
-/**
- * A module for adding retry and circuit breaker logic to asynchronous operations.
- *
- * @module retry
- */
 import type { Logger } from "./logger.js";
-/**
- * Defines the possible states of the circuit breaker.
- */
 export declare enum CircuitBreakerState {
-    /** The circuit is closed and allows operations to execute. */
     CLOSED = "CLOSED",
-    /** The circuit is open and fails operations immediately. */
     OPEN = "OPEN",
-    /** The circuit is half-open and allows a single trial operation. */
     HALF_OPEN = "HALF_OPEN"
 }
-/**
- * Represents the state and configuration of a circuit breaker.
- */
 export interface CircuitBreaker {
     state: CircuitBreakerState;
     failures: number;
@@ -26,47 +12,16 @@ export interface CircuitBreaker {
     readonly failureThreshold: number;
     onStateChange?: (newState: CircuitBreakerState, error?: Error) => void;
 }
-/**
- * Configuration options for the retry logic.
- */
 export interface RetryOptions {
-    /** The initial delay in milliseconds before the first retry. */
     initialDelay: number;
-    /** The maximum delay in milliseconds between retries. */
     maxDelay: number;
-    /** The exponential backoff factor. */
     factor: number;
-    /**
-     * A function that determines if an error is transient and should be retried.
-     * @param error The error to check.
-     * @returns `true` if the error is transient, otherwise `false`.
-     */
     isTransient: (error: any) => boolean;
-    /**
-     * A callback function executed on each retry attempt.
-     * @param error The error that caused the retry.
-     * @param attempt The current retry attempt number.
-     * @param delay The delay in milliseconds before the next attempt.
-     */
     onRetry: (error: any, attempt: number, delay: number) => void;
 }
-/**
- * Creates a new CircuitBreaker instance with default settings.
- * @param options Partial options to override defaults.
- * @returns A new CircuitBreaker instance.
- */
 export declare function createCircuitBreaker(options?: {
     resetTimeout?: number;
     failureThreshold?: number;
     onStateChange?: (newState: CircuitBreakerState, error?: Error) => void;
 }): CircuitBreaker;
-/**
- * Wraps an asynchronous operation with retry and circuit breaker logic.
- *
- * @template T The return type of the operation.
- * @param {() => Promise<T>} operation The asynchronous operation to execute.
- * @param {CircuitBreaker} circuitBreaker The circuit breaker instance to use.
- * @param {Partial<RetryOptions>} [retryOptions] Options for retry behavior.
- * @returns {Promise<T>} A promise that resolves with the result of the operation.
- */
 export declare function withRetry<T>(operation: () => Promise<T>, circuitBreaker: CircuitBreaker, retryOptions?: Partial<RetryOptions>, logger?: Logger): Promise<T>;