docs(ai): declare label?/onRetry? in the provider-dispatch typedefs (PR #45 review)

streamChat/complete/streamAgentTurn read o.label and o.onRetry, and pass onRetry as an
object literal into the openaiCompat adapters — but the @PARAM typedefs for both didn't
list them. Under // @ts-check that is 9 real diagnostics: TS2339 (property does not exist)
on each o.label / o.onRetry read, plus TS2353 (excess property) on each adapter literal.

Added label?:string and onRetry?:(info:{attempt,retries,status})=>void to the three
router typedefs, and onRetry? to the three adapter typedefs (they already carried label?).
The reviewer flagged label; onRetry has the same defect (added by the retry commit) and is
fixed in the same pass.

Verified with a real tsc 5.6 checkJs run — and not the vacuous kind: a synthetic probe
first confirmed tsc actually enforces TS2339/TS2353 here (an earlier npx form was silently
not running tsc at all), then stashing the fix gave BEFORE=9 label/onRetry errors, restoring
it gave AFTER=0. JSDoc-only; runtime unchanged (full gate 24 suites, 28 provider tests).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: ndemianc

extensions/levelcode-ai/providers/index.js

@@ -142,8 +142,9 @@ function secretStorageKey(id) {
 /**
  * Unified streaming chat across providers. `messages` is the shared {role,content:string} shape
  * (valid for both Anthropic and OpenAI). Anthropic → native adapter; everything else → openaiCompat.
- * @param {{providerId:string, apiKey?:string, baseURL?:string, model:string, maxTokens?:number,
- *          system:string, messages:any[], signal?:AbortSignal, onDelta:(t:string)=>void}} o
+ * @param {{providerId:string, apiKey?:string, baseURL?:string, label?:string, model:string, maxTokens?:number,
+ *          system:string, messages:any[], signal?:AbortSignal, onDelta:(t:string)=>void,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} o
  */
 async function streamChat(o) {
 	const p = getProvider(o.providerId);
@@ -163,8 +164,9 @@ async function streamChat(o) {
 
 /**
  * Unified one-shot completion across providers (inline ghost-text / edit). Returns full text.
- * @param {{providerId:string, apiKey?:string, baseURL?:string, model:string, maxTokens?:number,
- *          system:string, messages:any[], stop?:string[], signal?:AbortSignal}} o
+ * @param {{providerId:string, apiKey?:string, baseURL?:string, label?:string, model:string, maxTokens?:number,
+ *          system:string, messages:any[], stop?:string[], signal?:AbortSignal,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} o
  * @returns {Promise<string>}
  */
 async function complete(o) {
@@ -195,9 +197,10 @@ function supportsTools(id) {
  * translation); every other provider → the OpenAI adapter, which translates the Anthropic-shaped
  * transcript/tools in and the streamed tool-calls back out. Returns the SAME
  * {content, stop_reason, usage, malformed} shape for both, so agent.js is provider-agnostic.
- * @param {{providerId:string, apiKey?:string, baseURL?:string, model:string, maxTokens?:number,
+ * @param {{providerId:string, apiKey?:string, baseURL?:string, label?:string, model:string, maxTokens?:number,
  *          system:string, messages:any[], tools?:any[], signal?:AbortSignal,
- *          onText?:(t:string)=>void, onToolStart?:(name:string)=>void}} o
+ *          onText?:(t:string)=>void, onToolStart?:(name:string)=>void,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} o
  */
 async function streamAgentTurn(o) {
 	const p = getProvider(o.providerId);

extensions/levelcode-ai/providers/openaiCompat.js

@@ -174,7 +174,8 @@ async function postChat(opts, body) {
  * Streaming chat over /v1/chat/completions. opts.onDelta(text) per chunk; resolves at end.
  * @param {{baseURL:string, apiKey?:string, headers?:object, label?:string, model:string,
  *          maxTokens?:number, system?:string, messages:any[], stop?:string[],
- *          signal?:AbortSignal, onDelta:(t:string)=>void}} opts
+ *          signal?:AbortSignal, onDelta:(t:string)=>void,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} opts
  */
 async function streamOpenAI(opts) {
 	const label = opts.label || 'OpenAI-compatible';
@@ -196,7 +197,8 @@ async function streamOpenAI(opts) {
 /**
  * Non-streaming single completion (inline ghost-text / edit). Returns the full text.
  * @param {{baseURL:string, apiKey?:string, headers?:object, label?:string, model:string,
- *          maxTokens?:number, system?:string, messages:any[], stop?:string[], signal?:AbortSignal}} opts
+ *          maxTokens?:number, system?:string, messages:any[], stop?:string[], signal?:AbortSignal,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} opts
  * @returns {Promise<string>}
  */
 async function completeOpenAI(opts) {
@@ -248,7 +250,8 @@ async function listOpenAIModels(opts) {
  * to {type:'text'} / {type:'tool_use', id, name, input} blocks.
  * @param {{baseURL:string, apiKey?:string, headers?:object, label?:string, model:string,
  *          maxTokens?:number, system:string, messages:any[], tools?:any[], signal?:AbortSignal,
- *          onText?:(t:string)=>void, onToolStart?:(name:string)=>void}} opts
+ *          onText?:(t:string)=>void, onToolStart?:(name:string)=>void,
+ *          onRetry?:(info:{attempt:number,retries:number,status:number})=>void}} opts
  * @returns {Promise<{content:any[], stop_reason:string, usage:any, malformed:Set<string>}>}
  */
 async function streamOpenAIAgentTurn(opts) {