feat(shared): ProviderEntry.reasoningLevel + ReasoningLevel type

Adds the schema primitive for the upcoming Settings UI dropdown
("Reasoning depth" per provider). Shape:

  ReasoningLevel = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
  ProviderEntry.reasoningLevel?: ReasoningLevel

Backwards-compat: the field is optional, so existing configs read
without migration. When absent, core's reasoningForModel() continues
to compute the default from the provider id + model family. When
present, core honors the explicit override.

Schema version is not bumped because the field is optional and
purely additive.

Author: hqhq1025

packages/shared/src/config.ts

@@ -69,6 +69,9 @@ export type StoredDesignSystem = z.infer<typeof StoredDesignSystem>;
 
 // ── ProviderEntry (v3) ───────────────────────────────────────────────────────
 
+export const ReasoningLevelSchema = z.enum(['minimal', 'low', 'medium', 'high', 'xhigh']);
+export type ReasoningLevel = z.infer<typeof ReasoningLevelSchema>;
+
 export const ProviderEntrySchema = z.object({
   id: z.string().min(1),
   name: z.string().min(1),
@@ -80,6 +83,14 @@ export const ProviderEntrySchema = z.object({
   modelsHint: z.array(z.string()).optional(),
   httpHeaders: z.record(z.string(), z.string()).optional(),
   queryParams: z.record(z.string(), z.string()).optional(),
+  /**
+   * Per-provider reasoning effort override. When set, overrides the
+   * model-family default from `reasoningForModel` in core. Useful for
+   * proxies that gate reasoning tiers by plan (Claude Code consumer-tier
+   * accepts only 'medium') or for users who want to dial depth up/down
+   * per endpoint. The UI surfaces this as a "Reasoning depth" dropdown.
+   */
+  reasoningLevel: ReasoningLevelSchema.optional(),
 });
 export type ProviderEntry = z.infer<typeof ProviderEntrySchema>;
 

packages/shared/src/index.ts

@@ -225,6 +225,7 @@ export {
   ConfigV3Schema,
   PROVIDER_SHORTLIST,
   ProviderEntrySchema,
+  ReasoningLevelSchema,
   SUPPORTED_ONBOARDING_PROVIDERS,
   SecretRef,
   STORED_DESIGN_SYSTEM_SCHEMA_VERSION,
@@ -243,6 +244,7 @@ export type {
   OnboardingState,
   ProviderEntry,
   ProviderShortlist,
+  ReasoningLevel,
   SupportedOnboardingProvider,
   WireApi,
 } from './config';