import { evaluateDecisionRuleset } from './evaluate.js'; import type { DecisionAdapter } from './types.js'; import { type JevCredentialOptions } from './jev-credentials.js'; type AskMode = { kind: 'yes-no'; } | { kind: 'choices'; choices: string[]; } | { kind: 'scale'; low: number; high: number; }; export interface DecisionAskInput { question: string; mode: AskMode; context?: string; threshold?: number; timeoutMs?: number; passes?: number; escalationPasses?: number; minAgreement?: number; agreementConfidenceFloor?: number; } export interface DecisionAskPass { index: number; status: 'succeeded' | 'abstained' | 'failed'; reason: string; answer: string | boolean | number | null; confidence: number | null; probability?: number; model: string | null; usage: DecisionAskResult['usage']; latencyMs: number; } export interface DecisionAskAggregate { algorithm: 'majority-v1'; semantics: 'stability-signal-not-correctness'; passesRequested: number; escalationPasses: number; passesRun: number; escalated: boolean; earlyStop: 'certain-failure' | 'timeout' | null; agreementRatio: number; votes: Record; answer: string | boolean | number | null; confidenceSummary: { count: number; missing: number; mean: number | null; min: number | null; max: number | null; }; passes: DecisionAskPass[]; minAgreement?: number | null; agreementConfidenceFloor?: number; } export interface DecisionAskResult { schema: 'aiwg-decision-ask/v1'; status: 'answered' | 'fallback'; answer: string | boolean | number | null; confidence: number | null; probability?: number; fallback: null | 'llm'; reason: string; model: string | null; usage: { inputTokens: number | null; outputTokens: number | null; } | null; latencyMs: number; aggregate?: DecisionAskAggregate; /** Absent on legacy results; null on fallback. */ answeredBy?: 'confidence' | 'agreement' | null; } export interface DecisionAskRuntimeOptions extends JevCredentialOptions { /** CLI/MCP supply the project root to load project sampling defaults. */ cwd?: string; adapter?: DecisionAdapter; createAdapter?: (input: { region: string; endpoint?: string; }) => DecisionAdapter; resolveCredential?: (logicalRef: string) => Promise; evaluate?: typeof evaluateDecisionRuleset; now?: () => number; runId?: string; invocationId?: string; } export interface DecisionSetupInput { token?: string; region?: string; endpoint?: string; verify?: boolean; remove?: boolean; } export interface DecisionSetupResult { schema: 'aiwg-decision-jev-setup/v1'; configured: boolean; credentialSource: 'file' | 'env'; region: string; verified?: boolean; model?: string | null; usage?: { inputTokens: number | null; outputTokens: number | null; } | null; next: string[]; } export declare class DecisionAskUsageError extends Error { readonly reason: string; constructor(reason: string, message: string); } export declare function validateDecisionAskInput(input: DecisionAskInput): void; /** Product default: 5 passes, escalating to 10 when the first round is not decisive. */ export declare const DEFAULT_DECISION_PASSES = 5; /** Escalation defaults to twice the initial pass count (5 -> 10, 10 -> 20). */ export declare function defaultEscalationPasses(passes: number): number; export declare function askDecision(input: DecisionAskInput, options?: DecisionAskRuntimeOptions): Promise; export declare function readDecisionContextFile(filePath: string): Promise; export declare function setupJev(input?: DecisionSetupInput, options?: DecisionAskRuntimeOptions): Promise; export {}; //# sourceMappingURL=ask.d.ts.map