@juspay/neurolink/dist/utils/providerErrorClassification.d.ts

The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002

/**
 * Shared provider-error classification utilities used by both neurolink.ts and
 * the ModelPool routing subsystem.
 *
 * Extracted here to avoid duplication and to ensure that typed error classes
 * (AuthenticationError, AuthorizationError, ModelAccessDeniedError) are
 * checked consistently in both code paths.
 */
/**
 * Detects whether an error object looks like a model-access-denied condition.
 * Matches LiteLLM "team not allowed" / "team can only access models=[...]"
 * plus typed-error name/code markers when the full typed class is not present.
 */
export declare function looksLikeModelAccessDenied(error: unknown): boolean;
/**
 * Detects "the provider does not have this model": HTTP 404 model lookups,
 * Google's NOT_FOUND, Anthropic's `not_found_error` naming the model, and the
 * typed InvalidModelError providers raise for an unrecognised model id.
 *
 * Deliberately narrow. A 404 alone is not enough — only a 404 that names a
 * model qualifies, so an unrelated missing endpoint stays non-retryable.
 * Auth-flavoured messages are excluded outright: PERMISSION_DENIED means the
 * key is not entitled to the model, which every member sharing that key would
 * hit identically.
 */
export declare function looksLikeModelNotFound(error: unknown): boolean;
/**
 * Returns true when the error is definitively non-retryable: typed error
 * classes (auth, access-denied, invalid-model), non-retryable HTTP status
 * codes, or deterministic 400-class message patterns.
 *
 * NOTE: ContextBudgetExceededError is intentionally NOT non-retryable —
 * each provider has its own context window, so a budget rejection on one
 * provider does not preclude another provider accepting the same payload.
 *
 * NOTE: model-not-found IS non-retryable here, and intentionally so. This is
 * the general contract, used by provider fallback where the same model id
 * typically carries across providers — retrying a typo everywhere would turn
 * one crisp error into a slow fan-out of identical ones. ModelPool is the
 * exception and uses {@link isNonRetryableForPool} instead.
 */
export declare function isNonRetryableProviderError(error: unknown): boolean;
/**
 * Non-retryability as ModelPool sees it.
 *
 * A pool member is an explicit {provider, model} pair, and members are chosen
 * precisely because they differ. "This provider has no such model" is therefore
 * a fact about ONE member, not about the request: member#2 runs a different
 * model and may well serve it. Short-circuiting the whole pool on it defeats
 * the point of configuring a pool — the observed case was a member naming a
 * retired model, where Anthropic answered 404 and the pool gave up instead of
 * failing over to the member that was fine.
 *
 * Everything else keeps the general contract. Auth failures, malformed
 * payloads, and access-denied still stop the pool immediately, because those
 * describe the credentials or the request and every member would hit them.
 */
export declare function isNonRetryableForPool(error: unknown): boolean;