# AzureResponsesProvider

**Kind:** Class

**Source:** [`atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts#L61)

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<AIResponse>` |
| `generateWithStreaming` | `generateWithStreaming(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<AIResponse>` |
| `generateText` | `generateText(prompt: string, options: Omit<AIGenerateOptions, 'messages'>, stage: JobStage)` | `Promise<string>` |
| `generateJSON` | `generateJSON(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<{ data: T; response: AIResponse }>` |
| `generateWithStructuredOutput` | `generateWithStructuredOutput(options: {
    prompt: string;
    schema: object;
    model?: string;
  })` | `Promise<{ content: T; usage: { inputTokens: number; outputTokens: number } }>` |
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `getThrottlingStatus` | `getThrottlingStatus()` | `{ consecutiveFailures: number; adaptiveDelayMs: number; lastFailureTime: number }` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

## Where it refuses work

- `AzureResponsesProvider` stops the work with `Error` when `!config.endpoint` — “Azure Responses provider requires endpoint”.
- `AzureResponsesProvider` stops the work with `Error` when `!config.apiKey` — “Azure Responses provider requires apiKey”.
- `AzureResponsesProvider` stops the work with `AIProviderError` when `content.length === 0 && inputTokens === 0` — “Azure returned empty stream — throttled (429)”.
- `AzureResponsesProvider` stops the work with an early return when `error instanceof AIProviderError`.
- `AzureResponsesProvider` stops the work with an early return when `!response.ok`.

## When something fails

- `AzureResponsesProvider` handles failure in 5 places: it lets it reach the caller in 2, logs it and continues in 1, turns it into a return value in 1, and discards it silently in 1. A failure discarded silently leaves no trace for whoever debugs this later.