fix: clarify provider retry delay contract

packages/core/agent-loop/src/loop.ts

@@ -45,7 +45,9 @@ function finishError(finish: FinishReason): { error: RequestError; failure: LlmF
       const facts = finish.failure
       const error = new LlmError(facts.message, facts.code, {
         ...facts.status === undefined ? {} : { status: facts.status },
-        ...facts.retryAfterMs === undefined ? {} : { retryAfterMs: facts.retryAfterMs },
+        ...facts.providerRetryAfterMs === undefined
+          ? {}
+          : { providerRetryAfterMs: facts.providerRetryAfterMs },
         ...facts.requestId === undefined ? {} : { requestId: facts.requestId },
       })
       return { error, failure: error.failure }

packages/core/agent-loop/tests/contract-regressions.spec.ts

@@ -929,7 +929,7 @@ describe('a finish-error stream chunk ends the turn as error, not completed', ()
       message: 'provider 401',
       code: 'AUTH',
       status: 401,
-      retryAfterMs: 2_000,
+      providerRetryAfterMs: 2_000,
       requestId: ProviderRequestId('finish-request-1'),
     }
     const errorStream: StreamChunk[] = [

packages/core/agent-loop/tests/request-recovery.spec.ts

@@ -422,7 +422,7 @@ describe('agent post-step and request-error lifecycle', () => {
   it('passes structured facts beside the original Error and records them on exhaustion', async () => {
     const original = new LlmError('provider busy', 'RATE_LIMIT', {
       status: 429,
-      retryAfterMs: 2_000,
+      providerRetryAfterMs: 2_000,
       requestId: ProviderRequestId('req-9'),
     })
     Object.freeze(original)
@@ -448,7 +448,7 @@ describe('agent post-step and request-error lifecycle', () => {
       message: 'provider busy',
       code: 'RATE_LIMIT',
       status: 429,
-      retryAfterMs: 2_000,
+      providerRetryAfterMs: 2_000,
       requestId: ProviderRequestId('req-9'),
     })
     expect(seenHistory).toEqual([])