@jsonstudio/rcc 0.90.872 → 0.90.1270

package/docs/v2-architecture/PROVIDER-V2-PROFILE-API-REGISTRY-DRAFT.md

@@ -18,7 +18,7 @@
 - 已存在声明式 profile 输入：`src/providers/profile/provider-profile.ts`。
 - 已存在配置装载器：`src/providers/profile/provider-profile-loader.ts`。
 - 已存在 runtime metadata 承载 `providerProtocol/providerFamily/compatibilityProfile`：`src/providers/core/runtime/provider-runtime-metadata.ts`。
-- 当前 transport 内仍有大量品牌分支（iflow/antigravity 等），需要迁移到 family profile：`src/providers/core/runtime/http-transport-provider.ts`、`src/providers/core/runtime/http-request-executor.ts`。
+- 当前 transport 内仍有大量品牌分支（antigravity 等），需要迁移到 family profile：`src/providers/core/runtime/http-transport-provider.ts`、`src/providers/core/runtime/http-request-executor.ts`。
 
 ## 3. 抽象契约（API 草案）
 
@@ -72,7 +72,7 @@ interface ErrorPolicyInput {
 }
 
 interface ProviderFamilyProfile {
-  id: string;            // e.g. 'iflow/default'
+  id: string;            // e.g. 'antigravity/default'
   providerFamily: string;
 
   applyRequestPolicy?(input: RequestPolicyInput): RequestPolicyInput;
@@ -155,7 +155,7 @@ src/providers/
     profile-contracts.ts             # ProviderFamilyProfile interfaces
     profile-registry.ts              # register/resolve/getProfile
     families/
-      iflow/default-profile.ts
+      antigravity/default-profile.ts
       antigravity/default-profile.ts
       qwen/default-profile.ts
       gemini/default-profile.ts
@@ -173,7 +173,7 @@ src/providers/
 
 - 新增 `provider-directory.ts` + `profile-registry.ts`。
 - 新增 `profile-contracts.ts`。
-- 为 iflow/antigravity 提供最小 default profile（空实现 + 单测）。
+- 为 antigravity 提供最小 default profile（空实现 + 单测）。
 
 ### Step B（仅验证）
 

package/docs/v2-architecture/PROVIDER-V2-REFACTOR-OVERVIEW-DRAFT.md

@@ -37,13 +37,12 @@
 ## Phase A：实现不连线
 
 - 新建 profile contracts / registry / provider-directory
-- 新建 family profiles（iflow、antigravity、qwen、gemini）
+- 新建 family profiles（antigravity、qwen、gemini）
 - 新建 protocol adapters（4 协议）
 - 只加单测，不改主路径
 
 ## Phase B：分 wave 连线（新主旧影子）
 
-- Wave-1：iflow
 - Wave-2：antigravity / gemini-cli
 - Wave-3：protocol/factory/service-profile/provider-type 清理
 

package/docs/v2-architecture/PROVIDER-V2-VERIFICATION-MATRIX-DRAFT.md

@@ -26,8 +26,8 @@
 
 | Protocol | 受影响 Family（示例） | Same-shape 必测 | Control 必测 | Mandatory 指标 |
 |---|---|---|---|---|
-| openai-chat | iflow / qwen / glm / lmstudio | 1+ 样本（目标 family） | 1+ 样本（openai 或未改 family） | shape 一致、错误分类一致、无新增 P0/P1 |
-| openai-responses | iflow / openai / 其他 responses 路由 | 1+ 样本（目标 family） | 1+ 样本（responses 其他 family） | SSE/JSON 结构一致、工具回合一致 |
+| openai-chat | qwen / glm / lmstudio | 1+ 样本（目标 family） | 1+ 样本（openai 或未改 family） | shape 一致、错误分类一致、无新增 P0/P1 |
+| openai-responses | openai / 其他 responses 路由 | 1+ 样本（目标 family） | 1+ 样本（responses 其他 family） | SSE/JSON 结构一致、工具回合一致 |
 | anthropic-messages | anthropic / 兼容代理 | 1+ 样本（目标 family） | 1+ 样本（anthropic control） | tool alias / message shape 一致 |
 | gemini-chat | gemini / gemini-cli / antigravity | 1+ 样本（目标 family） | 1+ 样本（gemini family control） | header policy 与错误映射一致 |
 

package/node_modules/@jsonstudio/llms/dist/config-unified/unified-config.js

@@ -4,6 +4,16 @@ import path from 'path';
 import { resolveHostPaths } from './enhanced-path-resolver.js';
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const hasProviders = (value) => isRecord(value) && typeof value.providers === 'object' && value.providers !== null;
+const logUnifiedConfigNonBlocking = (stage, error, details = {}) => {
+    try {
+        const reason = error instanceof Error ? (error.stack || `${error.name}: ${error.message}`) : String(error);
+        const detailSuffix = Object.keys(details).length ? ` details=${JSON.stringify(details)}` : '';
+        console.warn(`[unified-config] ${stage} failed (non-blocking): ${reason}${detailSuffix}`);
+    }
+    catch {
+        // Never throw from non-blocking logging.
+    }
+};
 const readJsonSync = (file) => {
     try {
         return JSON.parse(fs.readFileSync(file, 'utf-8'));
@@ -127,7 +137,12 @@ export class UnifiedConfigFacade {
                 }
             }
         }
-        catch { /* ignore */ }
+        catch (error) {
+            logUnifiedConfigNonBlocking('context_budget.read_modules_json', error, {
+                configDir,
+                modelId
+            });
+        }
         // merged-config*.json
         try {
             const merged = listMergedConfigs(configDir);
@@ -143,8 +158,11 @@ export class UnifiedConfigFacade {
                 }
             }
         }
-        catch {
-            /* ignore */
+        catch (error) {
+            logUnifiedConfigNonBlocking('context_budget.scan_merged_configs', error, {
+                configDir,
+                modelId
+            });
         }
         // config.json
         try {
@@ -157,7 +175,12 @@ export class UnifiedConfigFacade {
                 }
             }
         }
-        catch { /* ignore */ }
+        catch (error) {
+            logUnifiedConfigNonBlocking('context_budget.read_config_json', error, {
+                configDir,
+                modelId
+            });
+        }
         // fallback
         const def = modulesDefault && modulesDefault > 0 ? modulesDefault : 200_000;
         const safety = Number.isFinite(safetyFromEnv) ? safetyFromEnv : (modulesSafety ?? 0.1);
@@ -201,13 +224,16 @@ export class UnifiedConfigFacade {
                 try {
                     this.watchers.forEach((fn) => fn({ file: file || '', event }));
                 }
-                catch {
-                    /* ignore */
+                catch (error) {
+                    logUnifiedConfigNonBlocking('watch_config.notify_callback', error, {
+                        file: file || '',
+                        event
+                    });
                 }
             });
         }
-        catch {
-            /* ignore */
+        catch (error) {
+            logUnifiedConfigNonBlocking('watch_config.open_fs_watch', error);
         }
     }
     unwatchConfig(cb) {
@@ -221,8 +247,8 @@ export class UnifiedConfigFacade {
             try {
                 this.fsWatcher.close();
             }
-            catch {
-                /* ignore */
+            catch (error) {
+                logUnifiedConfigNonBlocking('unwatch_config.close_fs_watch', error);
             }
             this.fsWatcher = null;
         }

package/node_modules/@jsonstudio/llms/dist/conversion/compat/actions/deepseek-web-request.js

@@ -48,6 +48,13 @@ function buildCompatInput(payload, adapterContext) {
         entryEndpoint: nativeContext.entryEndpoint ?? adapterContext?.entryEndpoint ?? DEFAULT_ENTRY_ENDPOINT,
         deepseek: resolveDeepseekNode(adapterContext)
     };
+    // Restore tools from __hub_capture if payload.tools was summarized (not array)
+    const capturedContext = adapterContext?.capturedContext;
+    const hubCapture = capturedContext?.__hub_capture;
+    const captureContext = hubCapture?.context;
+    if (!Array.isArray(payload.tools) && captureContext?.toolsRaw && Array.isArray(captureContext.toolsRaw)) {
+        payload = { ...payload, tools: captureContext.toolsRaw };
+    }
     return {
         payload,
         adapterContext: normalizedContext,

package/node_modules/@jsonstudio/llms/dist/conversion/compat/actions/deepseek-web-response.js

@@ -1,7 +1,7 @@
 import { buildNativeReqOutboundCompatAdapterContext } from '../../hub/pipeline/compat/native-adapter-context.js';
 import { runRespInboundStage3CompatWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-req-outbound-semantics.js';
 import { isNativeDisabledByEnv, makeNativeRequiredError } from '../../../router/virtual-router/engine-selection/native-router-hotpath-policy.js';
-import { providerErrorCenter } from '../../../router/virtual-router/error-center.js';
+import { reportProviderErrorToRouterPolicy } from '../../../router/virtual-router/provider-runtime-ingress.js';
 const PROFILE = 'chat:deepseek-web';
 const DEFAULT_PROVIDER_PROTOCOL = 'openai-chat';
 const DEFAULT_ENTRY_ENDPOINT = '/v1/chat/completions';
@@ -54,7 +54,7 @@ function buildRuntimeMetadata(adapterContext, payload, details) {
     return runtime;
 }
 function emitCompatError(error, adapterContext, payload, details) {
-    providerErrorCenter.emit({
+    reportProviderErrorToRouterPolicy({
         code: 'DEEPSEEK_WEB_COMPAT_ERROR',
         message: error.message,
         stage: 'compat:deepseek-web-response',

package/node_modules/@jsonstudio/llms/dist/conversion/compat/antigravity-session-signature.js

@@ -16,6 +16,11 @@ const SESSION_CACHE_LIMIT = 1000;
 // Keep rewind guard finite to avoid reusing stale signatures after a rewind.
 const REWIND_BLOCK_MS = 2 * 60 * 60 * 1000;
 const GLOBAL_PERSISTENCE_KEY = '__LLMSWITCH_ANTIGRAVITY_SESSION_SIGNATURE_PERSISTENCE__';
+function logAntigravitySignatureNonBlocking(stage, error, details = {}) {
+    const reason = error instanceof Error ? (error.stack || `${error.name}: ${error.message}`) : String(error);
+    const detailSuffix = Object.keys(details).length > 0 ? ` details=${JSON.stringify(details)}` : '';
+    console.warn(`[antigravity-session-signature] ${stage} failed (non-blocking): ${reason}${detailSuffix}`);
+}
 function getPersistenceState() {
     const g = globalThis;
     const existing = g[GLOBAL_PERSISTENCE_KEY];
@@ -43,8 +48,8 @@ export function configureAntigravitySessionSignaturePersistence(input) {
             delete process.env.ROUTECODEX_ANTIGRAVITY_SIGNATURE_STATE_DIR;
             delete process.env.ROUTECODEX_ANTIGRAVITY_SIGNATURE_FILE;
         }
-        catch {
-            // best-effort only
+        catch (error) {
+            logAntigravitySignatureNonBlocking('configure_persistence.clear_env', error);
         }
         return;
     }
@@ -68,16 +73,16 @@ export function configureAntigravitySessionSignaturePersistence(input) {
         process.env.ROUTECODEX_ANTIGRAVITY_SIGNATURE_STATE_DIR = stateDir;
         process.env.ROUTECODEX_ANTIGRAVITY_SIGNATURE_FILE = fileName;
     }
-    catch {
-        // best-effort only
+    catch (error) {
+        logAntigravitySignatureNonBlocking('configure_persistence.set_env', error, { stateDir, fileName });
     }
     // Ensure we hydrate immediately so a short-lived process (or a server restart)
     // never flushes an empty in-memory cache over an existing persisted file.
     try {
         hydrateSignaturesFromDiskIfNeeded(true);
     }
-    catch {
-        // best-effort only
+    catch (error) {
+        logAntigravitySignatureNonBlocking('configure_persistence.hydrate', error, { stateDir, fileName });
     }
 }
 export function flushAntigravitySessionSignaturePersistenceSync() {
@@ -515,8 +520,12 @@ function hydrateSignaturesFromDiskIfNeeded(force = false) {
                 messageCount: entry.messageCount
             });
         }
-        catch {
-            // best-effort native sync; JS cache remains source of truth for persistence
+        catch (error) {
+            logAntigravitySignatureNonBlocking('hydrate.native_sync_signature', error, {
+                aliasKey,
+                sessionId,
+                messageCount: entry.messageCount
+            });
         }
     };
     for (const [persistedKey, entry] of Object.entries(sessions)) {
@@ -665,12 +674,12 @@ function flushPersistedSignaturesSync(state) {
             state.loadedOnce = true;
             state.loadedMtimeMs = mtimeMs;
         }
-        catch {
-            // ignore
+        catch (error) {
+            logAntigravitySignatureNonBlocking('flush_persisted_signatures.refresh_mtime', error, { filePath });
         }
     }
-    catch {
-        // best-effort persistence: must not affect runtime
+    catch (error) {
+        logAntigravitySignatureNonBlocking('flush_persisted_signatures.write', error, { filePath });
     }
 }
 function schedulePersistenceFlush() {
@@ -744,7 +753,10 @@ export function getAntigravityRequestSessionMeta(requestId) {
             requestSessionIds.set(rid, { aliasKey: alias, sessionId: sid, messageCount, timestamp: ts });
             return { aliasKey: alias, sessionId: sid, messageCount };
         }
-        catch {
+        catch (error) {
+            logAntigravitySignatureNonBlocking('request_session.native_meta_lookup', error, {
+                requestId: rid
+            });
             return undefined;
         }
     }
@@ -870,8 +882,12 @@ export function cacheAntigravitySessionSignature(a, b, c, d = 1) {
             messageCount
         });
     }
-    catch {
-        // best-effort native sync; TS cache remains source for persistence semantics
+    catch (error) {
+        logAntigravitySignatureNonBlocking('cache_signature.native_sync', error, {
+            aliasKey,
+            sessionId,
+            messageCount
+        });
     }
 }
 function maybePinAntigravitySessionToAlias(aliasKeyInput, sessionIdInput, ts) {
@@ -1130,8 +1146,8 @@ export function resetAntigravitySessionSignatureCachesForTests() {
     try {
         resetAntigravitySignatureCachesWithNative();
     }
-    catch {
-        // best-effort
+    catch (error) {
+        logAntigravitySignatureNonBlocking('reset_native_caches', error);
     }
 }
 export function shouldTreatAsMissingThoughtSignature(value) {

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/header-policies.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Header Policies — pure functions for config-driven header injection.
+ *
+ * Replaces the hardcoded maybeInjectQwenHeaders / maybeInjectClaudeCodeHeaders
+ * functions in provider-normalization.ts. These functions are pure: they take
+ * data in, return data out, no global state, no side effects.
+ */
+import type { HeaderPolicyRule } from './types.js';
+/**
+ * Apply header policy rules to an existing headers record.
+ *
+ * @param existingHeaders - Current headers (may be undefined/empty)
+ * @param rules - Header policy rules from the compat profile config
+ * @param ctx - Provider context for matching
+ * @returns New headers record, or the original if no rules matched
+ */
+export declare function applyHeaderPolicies(existingHeaders: Record<string, string> | undefined, rules: HeaderPolicyRule[] | undefined, ctx: {
+    providerId: string;
+    providerType: string;
+}): Record<string, string> | undefined;

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/header-policies.js

@@ -0,0 +1,79 @@
+/**
+ * Header Policies — pure functions for config-driven header injection.
+ *
+ * Replaces the hardcoded maybeInjectQwenHeaders / maybeInjectClaudeCodeHeaders
+ * functions in provider-normalization.ts. These functions are pure: they take
+ * data in, return data out, no global state, no side effects.
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function hasHeader(headers, name) {
+    const lowered = name.trim().toLowerCase();
+    for (const key of Object.keys(headers)) {
+        if (key.trim().toLowerCase() === lowered) {
+            const value = headers[key];
+            if (typeof value === 'string' && value.trim()) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function matchesWhen(when, ctx) {
+    if (when.providerId !== undefined) {
+        if (ctx.providerId !== when.providerId.toLowerCase()) {
+            return false;
+        }
+    }
+    if (when.providerTypeContains !== undefined) {
+        if (!ctx.providerType.includes(when.providerTypeContains.toLowerCase())) {
+            return false;
+        }
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Apply header policy rules to an existing headers record.
+ *
+ * @param existingHeaders - Current headers (may be undefined/empty)
+ * @param rules - Header policy rules from the compat profile config
+ * @param ctx - Provider context for matching
+ * @returns New headers record, or the original if no rules matched
+ */
+export function applyHeaderPolicies(existingHeaders, rules, ctx) {
+    if (!rules || rules.length === 0) {
+        return existingHeaders;
+    }
+    const providerIdLower = ctx.providerId.trim().toLowerCase();
+    const providerTypeLower = ctx.providerType.trim().toLowerCase();
+    const matchCtx = { providerId: providerIdLower, providerType: providerTypeLower };
+    let result = existingHeaders;
+    for (const rule of rules) {
+        if (!matchesWhen(rule.when, matchCtx)) {
+            continue;
+        }
+        // At least one rule matched — ensure we have a mutable copy
+        if (result === existingHeaders) {
+            result = { ...(existingHeaders ?? {}) };
+        }
+        // setIfMissing: only set if header is not already present
+        if (rule.setIfMissing) {
+            for (const [key, value] of Object.entries(rule.setIfMissing)) {
+                if (!hasHeader(result, key)) {
+                    result[key] = value;
+                }
+            }
+        }
+        // set: unconditionally overwrite
+        if (rule.set) {
+            for (const [key, value] of Object.entries(rule.set)) {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/policy-overrides.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Policy Overrides — pure functions for config-driven policy skip/apply.
+ *
+ * Replaces the hardcoded profile string checks in policy-engine.ts
+ * (chat:deepseek-web skip). These functions are pure:
+ * data in, data out, no global state.
+ */
+import type { PolicyOverrideConfig } from './types.js';
+/**
+ * Check whether the policy phase should be skipped for a given profile.
+ *
+ * @param overrides - Policy override config from the compat profile
+ * @param phase - The policy phase to check ('observe' | 'enforce')
+ * @returns true if the phase should be skipped for this profile
+ */
+export declare function shouldSkipPolicy(overrides: PolicyOverrideConfig | undefined, phase: 'observe' | 'enforce'): boolean;

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/policy-overrides.js

@@ -0,0 +1,27 @@
+/**
+ * Policy Overrides — pure functions for config-driven policy skip/apply.
+ *
+ * Replaces the hardcoded profile string checks in policy-engine.ts
+ * (chat:deepseek-web skip). These functions are pure:
+ * data in, data out, no global state.
+ */
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Check whether the policy phase should be skipped for a given profile.
+ *
+ * @param overrides - Policy override config from the compat profile
+ * @param phase - The policy phase to check ('observe' | 'enforce')
+ * @returns true if the phase should be skipped for this profile
+ */
+export function shouldSkipPolicy(overrides, phase) {
+    if (!overrides) {
+        return false;
+    }
+    const phaseOverride = overrides[phase];
+    if (!phaseOverride) {
+        return false;
+    }
+    return phaseOverride.skip === true;
+}

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/provider-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Provider Resolver — config-driven replacements for hardcoded if-chains
+ * in provider-normalization.ts:
+ * - detectProviderType → detectProviderTypeFromConfig
+ * - mapOutboundProfile → resolveOutboundProfileFromConfig
+ * - resolveCompatibilityProfile (default part) → resolveDefaultCompatibilityProfileFromConfig
+ *
+ * Pure functions: data in, data out, no global state.
+ */
+import type { ProviderResolutionConfig } from './types.js';
+/**
+ * Detect provider type from provider config using keyword rules.
+ * Replaces hardcoded keyword if-chain in detectProviderType.
+ */
+export declare function detectProviderTypeFromConfig(config: ProviderResolutionConfig, provider: Record<string, unknown>): string;
+/**
+ * Resolve outbound wire protocol from provider type using config mapping.
+ * Replaces hardcoded if-chain in mapOutboundProfile.
+ */
+export declare function resolveOutboundProfileFromConfig(config: ProviderResolutionConfig, providerType: string): string;
+/**
+ * Resolve default compatibility profile from provider ID and config.
+ * Replaces hardcoded antigravity/gemini-cli if-chain in resolveCompatibilityProfile.
+ * Only handles the DEFAULT resolution — explicit compatibilityProfile from provider config takes precedence.
+ */
+export declare function resolveDefaultCompatibilityProfileFromConfig(config: ProviderResolutionConfig, providerId: string, provider: Record<string, unknown>): string;

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/provider-resolver.js

@@ -0,0 +1,59 @@
+/**
+ * Provider Resolver — config-driven replacements for hardcoded if-chains
+ * in provider-normalization.ts:
+ * - detectProviderType → detectProviderTypeFromConfig
+ * - mapOutboundProfile → resolveOutboundProfileFromConfig
+ * - resolveCompatibilityProfile (default part) → resolveDefaultCompatibilityProfileFromConfig
+ *
+ * Pure functions: data in, data out, no global state.
+ */
+/**
+ * Detect provider type from provider config using keyword rules.
+ * Replaces hardcoded keyword if-chain in detectProviderType.
+ */
+export function detectProviderTypeFromConfig(config, provider) {
+    const raw = (provider.providerType || provider.protocol || provider.type || '').toString().toLowerCase();
+    const id = (provider.providerId || provider.id || '').toString().toLowerCase();
+    const source = `${raw}|${id}`;
+    const lexicon = source.trim();
+    if (!lexicon)
+        return config.defaultProviderType;
+    for (const rule of config.typeKeywords) {
+        for (const keyword of rule.keywords) {
+            if (lexicon.includes(keyword.toLowerCase())) {
+                return rule.providerType;
+            }
+        }
+    }
+    return raw || config.defaultProviderType;
+}
+/**
+ * Resolve outbound wire protocol from provider type using config mapping.
+ * Replaces hardcoded if-chain in mapOutboundProfile.
+ */
+export function resolveOutboundProfileFromConfig(config, providerType) {
+    const value = providerType.toLowerCase();
+    return config.outboundProfiles[value] ?? config.defaultOutboundProfile;
+}
+/**
+ * Resolve default compatibility profile from provider ID and config.
+ * Replaces hardcoded antigravity/gemini-cli if-chain in resolveCompatibilityProfile.
+ * Only handles the DEFAULT resolution — explicit compatibilityProfile from provider config takes precedence.
+ */
+export function resolveDefaultCompatibilityProfileFromConfig(config, providerId, provider) {
+    const normalizedId = providerId.trim().toLowerCase();
+    const providerType = String(provider.providerType ?? provider.type ?? provider.protocol ?? '').toLowerCase();
+    for (const block of config.compatibilityProfileBlocks) {
+        if (block.providerId !== undefined) {
+            if (normalizedId === block.providerId.toLowerCase()) {
+                return block.compatibilityProfile;
+            }
+        }
+        if (block.providerTypeContains !== undefined) {
+            if (providerType.includes(block.providerTypeContains.toLowerCase())) {
+                return block.compatibilityProfile;
+            }
+        }
+    }
+    return config.defaultCompatibilityProfile;
+}

package/node_modules/@jsonstudio/llms/dist/conversion/compat/profile-registry/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Compat Profile Registry — loader and lookup.
+ *
+ * Parallel implementation (Step A). Loads all profile JSON files from disk,
+ * applies extended fields (headerPolicies, policyOverrides), and exposes
+ * a typed registry for downstream consumers.
+ *
+ * This is the THIN SHELL layer. The heavy validation (schema enforcement,
+ * action registration checks) will move to Rust per Guard #8.
+ * For now, we do minimal structural validation and fail-fast on missing data.
+ */
+import type { CompatProfileEntry, CompatProfileRegistry, HeaderPolicyRule, PolicyOverrideConfig, ProviderResolutionConfig } from './types.js';
+export type { CompatProfileEntry, CompatProfileRegistry, HeaderPolicyRule, PolicyOverrideConfig, ProviderResolutionConfig };
+/**
+ * Load all compat profile JSON files from the profiles directory.
+ * Returns a registry with profiles keyed by id.
+ *
+ * Fails fast on:
+ * - Missing or unreadable profiles directory
+ * - Invalid JSON in any profile file
+ * - Profile missing 'id' or 'protocol' fields
+ */
+export declare function loadCompatProfileRegistry(profilesDir?: string): CompatProfileRegistry;
+/**
+ * Look up a profile by id. Throws if not found (fail-fast, no fallback).
+ */
+export declare function getProfile(registry: CompatProfileRegistry, profileId: string): CompatProfileEntry;
+/**
+ * Get header policy rules for a profile (empty array if none).
+ */
+export declare function getHeaderPolicies(registry: CompatProfileRegistry, profileId: string): HeaderPolicyRule[];
+/**
+ * Get policy overrides for a profile (undefined if none).
+ */
+export declare function getPolicyOverrides(registry: CompatProfileRegistry, profileId: string): PolicyOverrideConfig | undefined;