konsilio 0.3.0

package/build/logger.js

@@ -0,0 +1,121 @@
+/**
+ * Pino-based Structured Logger with correlation ID support
+ *
+ * Outputs structured JSON logs to stderr for observability and debugging.
+ * IMPORTANT: MCP servers MUST use stderr for logs - stdout is reserved for JSON-RPC protocol.
+ */
+import pino from 'pino';
+/**
+ * Get the log level from environment variables
+ * Defaults to 'info' if not set or invalid
+ */
+function getLogLevelFromEnv() {
+    const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+    const validLevels = ['debug', 'info', 'warn', 'error'];
+    if (envLevel && validLevels.includes(envLevel)) {
+        return envLevel;
+    }
+    return 'info';
+}
+/**
+ * Pino-backed Logger implementation
+ */
+class PinoLogger {
+    pino;
+    constructor(level) {
+        this.pino = pino({
+            level: level ?? getLogLevelFromEnv(),
+            base: {
+                service: 'konsilio',
+            },
+            timestamp: pino.stdTimeFunctions.isoTime,
+        }, 
+        // MCP servers MUST log to stderr - stdout is reserved for JSON-RPC protocol
+        pino.destination({ dest: 2, sync: true }));
+    }
+    debug(message, data, correlationId) {
+        if (correlationId) {
+            this.pino.child({ correlationId }).debug(data ?? {}, message);
+        }
+        else {
+            this.pino.debug(data ?? {}, message);
+        }
+    }
+    info(message, data, correlationId) {
+        if (correlationId) {
+            this.pino.child({ correlationId }).info(data ?? {}, message);
+        }
+        else {
+            this.pino.info(data ?? {}, message);
+        }
+    }
+    warn(message, data, correlationId) {
+        if (correlationId) {
+            this.pino.child({ correlationId }).warn(data ?? {}, message);
+        }
+        else {
+            this.pino.warn(data ?? {}, message);
+        }
+    }
+    error(message, data, correlationId) {
+        if (correlationId) {
+            this.pino.child({ correlationId }).error(data ?? {}, message);
+        }
+        else {
+            this.pino.error(data ?? {}, message);
+        }
+    }
+    withCorrelationId(correlationId) {
+        return new PinoCorrelatedLogger(this.pino.child({ correlationId }));
+    }
+}
+/**
+ * Correlated logger implementation using Pino child logger
+ */
+class PinoCorrelatedLogger {
+    childLogger;
+    constructor(childLogger) {
+        this.childLogger = childLogger;
+    }
+    debug(message, data) {
+        this.childLogger.debug(data ?? {}, message);
+    }
+    info(message, data) {
+        this.childLogger.info(data ?? {}, message);
+    }
+    warn(message, data) {
+        this.childLogger.warn(data ?? {}, message);
+    }
+    error(message, data) {
+        this.childLogger.error(data ?? {}, message);
+    }
+}
+/**
+ * Singleton logger instance configured from LOG_LEVEL env var
+ */
+export const logger = new PinoLogger();
+/**
+ * Create a logger instance with the specified log level
+ * @param level - Optional log level (defaults to LOG_LEVEL env var or 'info')
+ */
+export function createLogger(level) {
+    return new PinoLogger(level);
+}
+/**
+ * Get a child logger with correlation ID embedded in all log entries
+ * Convenience function equivalent to logger.withCorrelationId()
+ *
+ * @param correlationId - The correlation ID to include in all log entries
+ * @returns A logger instance with the correlation ID
+ */
+export function getLogger(correlationId) {
+    return logger.withCorrelationId(correlationId);
+}
+// Export convenience methods for direct use without correlation ID
+export const log = {
+    debug: (message, data) => logger.debug(message, data),
+    info: (message, data) => logger.info(message, data),
+    warn: (message, data) => logger.warn(message, data),
+    error: (message, data) => logger.error(message, data),
+};
+//# sourceMappingURL=logger.js.map

package/build/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/build/personas/expert.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Expert Class
+ *
+ * Runtime persona construction from markdown files.
+ * Replaces individual persona TypeScript files.
+ */
+import type { PersonaPromptData } from '../services/prompt.service.js';
+import type { Persona } from './schemas.js';
+export interface ExpertConfig {
+    personaId: string;
+    model: string;
+    expertRules: string;
+    workflowRules?: string;
+    promptService: {
+        loadPersonaPromptData: (id: string) => PersonaPromptData;
+    };
+}
+/**
+ * Expert - Runtime persona construction
+ */
+export declare class Expert implements Persona {
+    readonly id: string;
+    readonly name: string;
+    readonly emoji: string;
+    readonly focusAreas: string[];
+    readonly domains?: string[];
+    readonly systemPrompt: string;
+    constructor(config: ExpertConfig);
+    /**
+     * Build the system prompt for the expert
+     */
+    private buildSystemPrompt;
+}

package/build/personas/expert.js

@@ -0,0 +1,46 @@
+/**
+ * Expert Class
+ *
+ * Runtime persona construction from markdown files.
+ * Replaces individual persona TypeScript files.
+ */
+/**
+ * Expert - Runtime persona construction
+ */
+export class Expert {
+    id;
+    name;
+    emoji;
+    focusAreas;
+    domains;
+    systemPrompt;
+    constructor(config) {
+        const personaData = config.promptService.loadPersonaPromptData(config.personaId);
+        this.id = personaData.id;
+        this.name = personaData.name;
+        this.emoji = personaData.emoji;
+        this.focusAreas = personaData.focusAreas;
+        this.domains = personaData.domains;
+        this.systemPrompt = this.buildSystemPrompt(personaData, config);
+    }
+    /**
+     * Build the system prompt for the expert
+     */
+    buildSystemPrompt(data, config) {
+        const parts = [];
+        // Expert rules (always included for experts)
+        parts.push(config.expertRules);
+        // Workflow rules (optional)
+        if (config.workflowRules) {
+            parts.push('\n' + config.workflowRules);
+        }
+        // Persona-specific content
+        parts.push(`\nYou are a ${data.name}. Review the draft plan for architecture issues within your domain.\n`);
+        // Anti-patterns
+        if (data.antiPatterns.length > 0) {
+            parts.push('## Anti-Patterns\n\n' + data.antiPatterns.map((ap, i) => `${i + 1}. ${ap}`).join('\n') + '\n');
+        }
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=expert.js.map

package/build/personas/expert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expert.js","sourceRoot":"","sources":["../../src/personas/expert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,MAAM,OAAO,MAAM;IACD,EAAE,CAAS;IACX,IAAI,CAAS;IACb,KAAK,CAAS;IACd,UAAU,CAAW;IACrB,OAAO,CAAY;IACnB,YAAY,CAAS;IAErC,YAAY,MAAoB;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjF,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,IAAuB,EACvB,MAAoB;QAEpB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,6CAA6C;QAC7C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE/B,4BAA4B;QAC5B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1C,CAAC;QAED,2BAA2B;QAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,uEAAuE,CAAC,CAAC;QAE5G,gBAAgB;QAChB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7G,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/build/personas/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Persona Index - Types and Classes
+ *
+ * This module exports persona types and classes.
+ * Persona creation is handled by PersonaService.
+ */
+export * from './schemas.js';
+export { Expert, type ExpertConfig } from './expert.js';
+export { Lead, type LeadConfig } from './lead.js';

package/build/personas/index.js

@@ -0,0 +1,11 @@
+/**
+ * Persona Index - Types and Classes
+ *
+ * This module exports persona types and classes.
+ * Persona creation is handled by PersonaService.
+ */
+// Export schemas and types
+export * from './schemas.js';
+export { Expert } from './expert.js';
+export { Lead } from './lead.js';
+//# sourceMappingURL=index.js.map

package/build/personas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/personas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2BAA2B;AAC3B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,IAAI,EAAmB,MAAM,WAAW,CAAC"}

package/build/personas/lead.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lead Class
+ *
+ * Runtime lead construction for consolidation phases.
+ * Loads phase-specific prompts from markdown files.
+ */
+import type { Persona } from './schemas.js';
+export interface LeadConfig {
+    phase: 'extraction' | 'critique' | 'decision' | 'synthesis';
+    workflowRules?: string;
+    promptService: {
+        loadConsolidationPhase: (phase: 'extraction' | 'critique' | 'decision' | 'synthesis') => string;
+    };
+}
+/**
+ * Lead - Runtime lead construction for consolidation phases
+ */
+export declare class Lead implements Persona {
+    readonly id: string;
+    readonly name: string;
+    readonly emoji: string;
+    readonly focusAreas: string[];
+    readonly systemPrompt: string;
+    constructor(config: LeadConfig);
+    /**
+     * Get human-readable phase name
+     */
+    private getPhaseName;
+    /**
+     * Build the system prompt for the lead
+     */
+    private buildSystemPrompt;
+}

package/build/personas/lead.js

@@ -0,0 +1,51 @@
+/**
+ * Lead Class
+ *
+ * Runtime lead construction for consolidation phases.
+ * Loads phase-specific prompts from markdown files.
+ */
+/**
+ * Lead - Runtime lead construction for consolidation phases
+ */
+export class Lead {
+    id;
+    name;
+    emoji;
+    focusAreas;
+    systemPrompt;
+    constructor(config) {
+        this.id = `lead-${config.phase}`;
+        this.name = this.getPhaseName(config.phase);
+        this.emoji = '👑';
+        this.focusAreas = [config.phase];
+        this.systemPrompt = this.buildSystemPrompt(config);
+    }
+    /**
+     * Get human-readable phase name
+     */
+    getPhaseName(phase) {
+        const names = {
+            extraction: 'Extraction Lead',
+            critique: 'Critique Lead',
+            decision: 'Decision Lead',
+            synthesis: 'Synthesis Lead',
+        };
+        return names[phase] ?? 'Lead';
+    }
+    /**
+     * Build the system prompt for the lead
+     */
+    buildSystemPrompt(config) {
+        const parts = [];
+        // Workflow rules (optional)
+        if (config.workflowRules) {
+            parts.push(config.workflowRules);
+            parts.push('\n');
+        }
+        // Phase-specific prompt
+        const phasePrompt = config.promptService.loadConsolidationPhase(config.phase);
+        parts.push(phasePrompt);
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=lead.js.map

package/build/personas/lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead.js","sourceRoot":"","sources":["../../src/personas/lead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,OAAO,IAAI;IACC,EAAE,CAAS;IACX,IAAI,CAAS;IACb,KAAK,CAAS;IACd,UAAU,CAAW;IACrB,YAAY,CAAS;IAErC,YAAY,MAAkB;QAC5B,IAAI,CAAC,EAAE,GAAG,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAA2D;QAC9E,MAAM,KAAK,GAA2B;YACpC,UAAU,EAAE,iBAAiB;YAC7B,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,eAAe;YACzB,SAAS,EAAE,gBAAgB;SAC5B,CAAC;QACF,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,MAAkB;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,4BAA4B;QAC5B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,wBAAwB;QACxB,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,sBAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAExB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/build/personas/schemas.d.ts

@@ -0,0 +1,313 @@
+import { z } from 'zod';
+export declare const StructuredFindingSchema: z.ZodObject<{
+    id: z.ZodString;
+    severity: z.ZodEnum<{
+        CRITICAL: "CRITICAL";
+        HIGH: "HIGH";
+        MEDIUM: "MEDIUM";
+        LOW: "LOW";
+    }>;
+    component: z.ZodString;
+    issue: z.ZodString;
+    mitigation: z.ZodString;
+}, z.core.$strip>;
+export declare const StructuredRiskSchema: z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<{
+        security: "security";
+        performance: "performance";
+        operational: "operational";
+        ux: "ux";
+        "technical-debt": "technical-debt";
+    }>;
+    probability: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    impact: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    description: z.ZodString;
+}, z.core.$strip>;
+export declare const StructuredExpertOutputSchema: z.ZodObject<{
+    personaId: z.ZodString;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<{
+            CRITICAL: "CRITICAL";
+            HIGH: "HIGH";
+            MEDIUM: "MEDIUM";
+            LOW: "LOW";
+        }>;
+        component: z.ZodString;
+        issue: z.ZodString;
+        mitigation: z.ZodString;
+    }, z.core.$strip>>;
+    risks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            security: "security";
+            performance: "performance";
+            operational: "operational";
+            ux: "ux";
+            "technical-debt": "technical-debt";
+        }>;
+        probability: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        impact: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    missingAssumptions: z.ZodArray<z.ZodString>;
+    dependencies: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const ExtractedClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    personaId: z.ZodString;
+    findingId: z.ZodString;
+    claim: z.ZodString;
+    context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const ExtractionPhaseOutputSchema: z.ZodObject<{
+    claims: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        personaId: z.ZodString;
+        findingId: z.ZodString;
+        claim: z.ZodString;
+        context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    totalFindings: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ContradictionSchema: z.ZodObject<{
+    id: z.ZodString;
+    personaA: z.ZodString;
+    personaB: z.ZodString;
+    findingA: z.ZodString;
+    findingB: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export declare const UnsupportedClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    personaId: z.ZodString;
+    findingId: z.ZodString;
+    claim: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const ReasoningScoreSchema: z.ZodObject<{
+    personaId: z.ZodString;
+    score: z.ZodNumber;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const CritiquePhaseOutputSchema: z.ZodObject<{
+    contradictions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        personaA: z.ZodString;
+        personaB: z.ZodString;
+        findingA: z.ZodString;
+        findingB: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    unsupportedClaims: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        personaId: z.ZodString;
+        findingId: z.ZodString;
+        claim: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    reasoningScores: z.ZodArray<z.ZodObject<{
+        personaId: z.ZodString;
+        score: z.ZodNumber;
+        reasoning: z.ZodString;
+    }, z.core.$strip>>;
+    consensusRisks: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const DecisionSchema: z.ZodObject<{
+    findingId: z.ZodString;
+    personaId: z.ZodString;
+    action: z.ZodEnum<{
+        ACCEPT: "ACCEPT";
+        REJECT: "REJECT";
+    }>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const ConflictResolutionSchema: z.ZodObject<{
+    contradictionId: z.ZodString;
+    selectedPersona: z.ZodString;
+    selectedFindingId: z.ZodString;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const DecisionPhaseOutputSchema: z.ZodObject<{
+    decisions: z.ZodArray<z.ZodObject<{
+        findingId: z.ZodString;
+        personaId: z.ZodString;
+        action: z.ZodEnum<{
+            ACCEPT: "ACCEPT";
+            REJECT: "REJECT";
+        }>;
+        reasoning: z.ZodString;
+    }, z.core.$strip>>;
+    resolutions: z.ZodArray<z.ZodObject<{
+        contradictionId: z.ZodString;
+        selectedPersona: z.ZodString;
+        selectedFindingId: z.ZodString;
+        reasoning: z.ZodString;
+    }, z.core.$strip>>;
+    acceptedCount: z.ZodNumber;
+    rejectedCount: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SynthesisPhaseOutputSchema: z.ZodObject<{
+    blueprint: z.ZodString;
+    acceptedFindings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<{
+            CRITICAL: "CRITICAL";
+            HIGH: "HIGH";
+            MEDIUM: "MEDIUM";
+            LOW: "LOW";
+        }>;
+        component: z.ZodString;
+        issue: z.ZodString;
+        mitigation: z.ZodString;
+    }, z.core.$strip>>;
+    attributions: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export interface Persona {
+    id: string;
+    name: string;
+    emoji: string;
+    systemPrompt: string;
+    focusAreas: string[];
+    domains?: string[];
+}
+export interface ExpertReport {
+    personaId: string;
+    personaName: string;
+    personaEmoji: string;
+    structuredOutput: StructuredExpertOutput;
+    rawContent: string;
+    durationMs: number;
+    modelUsed: string;
+}
+export interface CouncilResult {
+    sessionId: string;
+    expertReports: ExpertReport[];
+    extractionOutput: ExtractionPhaseOutput;
+    critiqueOutput: CritiquePhaseOutput;
+    decisionOutput: DecisionPhaseOutput;
+    synthesisOutput: SynthesisPhaseOutput;
+    finalBlueprint: string;
+    consolidationModel: string;
+    totalDurationMs: number;
+    formattingDetails?: {
+        totalFormattingTimeMs: number;
+        formattingSuccessRate: number;
+        formattingErrors: string[];
+    };
+}
+export interface ProseExpertOutput {
+    personaId: string;
+    analysis: string;
+    confidence: number;
+    keyInsights: string[];
+}
+export interface FormattedExpertOutput extends StructuredExpertOutput {
+    formattingConfidence: number;
+    originalProse: string;
+}
+export type StructuredFinding = z.infer<typeof StructuredFindingSchema>;
+export type StructuredRisk = z.infer<typeof StructuredRiskSchema>;
+export type StructuredExpertOutput = z.infer<typeof StructuredExpertOutputSchema>;
+export type ExtractedClaim = z.infer<typeof ExtractedClaimSchema>;
+export type ExtractionPhaseOutput = z.infer<typeof ExtractionPhaseOutputSchema>;
+export type Contradiction = z.infer<typeof ContradictionSchema>;
+export type UnsupportedClaim = z.infer<typeof UnsupportedClaimSchema>;
+export type ReasoningScore = z.infer<typeof ReasoningScoreSchema>;
+export type CritiquePhaseOutput = z.infer<typeof CritiquePhaseOutputSchema>;
+export type Decision = z.infer<typeof DecisionSchema>;
+export type ConflictResolution = z.infer<typeof ConflictResolutionSchema>;
+export type DecisionPhaseOutput = z.infer<typeof DecisionPhaseOutputSchema>;
+export type SynthesisPhaseOutput = z.infer<typeof SynthesisPhaseOutputSchema>;
+/**
+ * Convert a Zod schema to OpenAI response_format structure.
+ * Strips the $schema key and produces clean JSON Schema for strict mode.
+ */
+export declare function toResponseFormat(schema: z.ZodType, name: string): {
+    type: "json_schema";
+    json_schema: {
+        name: string;
+        strict: boolean;
+        schema: {
+            [k: string]: unknown;
+            "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+            $id?: string;
+            $anchor?: string;
+            $ref?: string;
+            $dynamicRef?: string;
+            $dynamicAnchor?: string;
+            $vocabulary?: Record<string, boolean>;
+            $comment?: string;
+            $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+            type?: "object" | "array" | "string" | "number" | "boolean" | "null" | "integer";
+            additionalItems?: z.core.JSONSchema._JSONSchema;
+            unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+            prefixItems?: z.core.JSONSchema._JSONSchema[];
+            items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+            contains?: z.core.JSONSchema._JSONSchema;
+            additionalProperties?: z.core.JSONSchema._JSONSchema;
+            unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+            properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+            patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+            dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+            propertyNames?: z.core.JSONSchema._JSONSchema;
+            if?: z.core.JSONSchema._JSONSchema;
+            then?: z.core.JSONSchema._JSONSchema;
+            else?: z.core.JSONSchema._JSONSchema;
+            allOf?: z.core.JSONSchema.JSONSchema[];
+            anyOf?: z.core.JSONSchema.JSONSchema[];
+            oneOf?: z.core.JSONSchema.JSONSchema[];
+            not?: z.core.JSONSchema._JSONSchema;
+            multipleOf?: number;
+            maximum?: number;
+            exclusiveMaximum?: number | boolean;
+            minimum?: number;
+            exclusiveMinimum?: number | boolean;
+            maxLength?: number;
+            minLength?: number;
+            pattern?: string;
+            maxItems?: number;
+            minItems?: number;
+            uniqueItems?: boolean;
+            maxContains?: number;
+            minContains?: number;
+            maxProperties?: number;
+            minProperties?: number;
+            required?: string[];
+            dependentRequired?: Record<string, string[]>;
+            enum?: Array<string | number | boolean | null>;
+            const?: string | number | boolean | null;
+            id?: string;
+            title?: string;
+            description?: string;
+            default?: unknown;
+            deprecated?: boolean;
+            readOnly?: boolean;
+            writeOnly?: boolean;
+            nullable?: boolean;
+            examples?: unknown[];
+            format?: string;
+            contentMediaType?: string;
+            contentEncoding?: string;
+            contentSchema?: z.core.JSONSchema.JSONSchema;
+            _prefault?: unknown;
+        };
+    };
+};