# Interface FeedErrorMeta

Optional machine-readable metadata attached to an empty/failed feed response.

Allows downstream consumers to classify the failure and decide whether to retry the request, fall back to a non-feed endpoint, or skip entirely.

interface FeedErrorMeta {
errorCode?: FeedErrorCode;
retryable?: boolean;
retryAfterMs?: number;
upstream?: { errorMessage?: string; statusCode?: number };
}

- Defined in tools/shared/feedUtils.ts:114

##### Index

### Properties

errorCode?
retryable?
retryAfterMs?
upstream?

## Properties

### `Optional` errorCode

errorCode?: FeedErrorCode

Machine-readable failure classification.

- Defined in tools/shared/feedUtils.ts:116

### `Optional` retryable

retryable?: boolean

Whether the failure is transient and the request should be retried.

- Defined in tools/shared/feedUtils.ts:118

### `Optional` retryAfterMs

retryAfterMs?: number

Suggested delay (in milliseconds) before retrying, when known.

Populated for `RATE_LIMIT` failures originating from the local token-bucket limiter (where the wait time is precisely known) and may be populated for upstream rate-limits when a `Retry-After` value is parsed.

- Defined in tools/shared/feedUtils.ts:126

### `Optional` upstream

upstream?: { errorMessage?: string; statusCode?: number }

Information about the upstream error, when available.

#### Type Declaration

- ##### `Optional` errorMessage?: string

  Raw error message from the upstream response body.

- ##### `Optional` statusCode?: number

  HTTP status code parsed from the upstream error message, if present.

- Defined in tools/shared/feedUtils.ts:128