import type { DecisionResult, ArtifactPin } from '../decision/types.js'; /** Experimental D27 shadow route. Never installs, invokes, or authorizes a capability. */ export interface DiscoveryCandidate { id: string; name: string; type: string; capability: string; score: number; } export interface DiscoveryAmbiguityPolicy { version: 'discovery-ambiguity/v1'; minimumScore: number; /** A margin equal to this threshold bypasses inference. */ minimumMargin: number; maximumCandidates: number; maximumTextBytes: number; } export type DiscoveryRouteReason = 'disabled' | 'exact-name' | 'high-margin' | 'no-candidates' | 'low-score' | 'low-margin' | 'cross-type' | 'invalid-input' | 'circuit-open'; export interface DiscoveryAmbiguity { version: DiscoveryAmbiguityPolicy['version']; eligible: boolean; reason: DiscoveryRouteReason; } /** Retrieval order is authoritative, including ties; this function never sorts it. */ export declare function discoveryAmbiguity(query: string, candidates: readonly DiscoveryCandidate[], policy: DiscoveryAmbiguityPolicy): DiscoveryAmbiguity; export interface DiscoveryShadowPolicy { mode: 'disabled' | 'shadow'; ambiguity: DiscoveryAmbiguityPolicy; definition: ArtifactPin; binding: ArtifactPin; allowedModels: readonly string[]; uncertaintyProfile: string; calibrationDigest: string; minimumProbability: number; minimumMargin: number; maximumLatencyMs: number; maximumTokens: number; maximumCostUsd: number; } export interface DiscoveryShadowRequest { query: string; /** Opaque choices prevent candidate text or IDs from becoming control fields. */ candidates: ReadonlyArray<{ option: string; id: string; name: string; type: string; capability: string; }>; options: readonly string[]; definition: ArtifactPin; binding: ArtifactPin; signal: AbortSignal; } export interface DiscoveryShadowHost { /** Trusted host performs D10 projection/egress/admission BEFORE resolver/transport access. * Return only a normalized result backed by a durable receipt. No raw response here. */ evaluate(request: DiscoveryShadowRequest): Promise<{ result: DecisionResult; receiptDigest: string; }>; /** Explicit trusted-host authorization of the query and bounded candidate projection. */ authorize(request: Omit): boolean; /** Store the complete result only under the host's normal D10 scope/lifecycle policy. */ record(receipt: DiscoveryShadowReceipt): void; clock?: () => number; } export interface DiscoveryShadowReceipt { schemaVersion: 'discovery-shadow/v1'; route: 'deterministic-only' | 'shadow'; reason: DiscoveryRouteReason | 'privacy-denied' | 'evaluation-failed' | 'rejected-evidence' | 'budget-breach' | 'accepted-shadow'; ambiguityReason: DiscoveryRouteReason; /** Digests only: no query, names, capability descriptions, private paths or raw result. */ candidatesDigest: string; policyDigest: string; selection: { kind: 'none'; } | { kind: 'candidate'; ordinal: number; } | null; resultDigest: string | null; servedModel: string | null; latencyMs: number; usage: { tokens: number | null; costUsd: number | null; }; } /** One host-owned circuit per workload. Drift/quality controls can trip it without changing * any index or active decision pins. Re-enabling requires a newly constructed route. */ export declare class DiscoveryShadowRoute { private readonly host; private readonly policy; private stopped; private readonly active; constructor(policy: DiscoveryShadowPolicy, host: DiscoveryShadowHost); disable(): void; get disabled(): boolean; /** Return metadata via the governed sink. Caller results always retain baseline order. */ observe(query: string, baseline: readonly DiscoveryCandidate[]): Promise; } export { DiscoveryShadowEvaluator, type DiscoveryShadowEvaluatorConfig } from './discovery-shadow-evaluator.js'; //# sourceMappingURL=discovery-shadow.d.ts.map