@sebastientang/llm-council 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,393 @@
+import { z } from 'zod';
+
+interface CompletionRequest {
+    model: string;
+    systemPrompt: string;
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    temperature?: number;
+    maxTokens?: number;
+}
+interface CompletionResponse {
+    content: string;
+    tokenCount: {
+        input: number;
+        output: number;
+    };
+    model: string;
+}
+interface LLMProvider {
+    id: string;
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+}
+declare const ParticipantSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodString;
+    systemPrompt: z.ZodString;
+    temperature: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    systemPrompt: string;
+    temperature?: number | undefined;
+}, {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    systemPrompt: string;
+    temperature?: number | undefined;
+}>;
+type Participant = z.infer<typeof ParticipantSchema>;
+interface PromptRequest {
+    participantId: string;
+    provider: string;
+    model: string;
+    systemPrompt: string;
+    userMessage: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+interface Protocol {
+    buildPrompts(config: DeliberationConfig, history: DeliberationMessage[], round: number): PromptRequest[];
+    getRoundCount(): number;
+}
+declare const SynthesisSchema: z.ZodObject<{
+    recommendation: z.ZodString;
+    confidence: z.ZodNumber;
+    reasoning: z.ZodString;
+    risks: z.ZodArray<z.ZodString, "many">;
+    dissent: z.ZodArray<z.ZodString, "many">;
+    validationGates: z.ZodArray<z.ZodString, "many">;
+    assumptions: z.ZodArray<z.ZodString, "many">;
+    raw: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recommendation: string;
+    confidence: number;
+    reasoning: string;
+    risks: string[];
+    dissent: string[];
+    validationGates: string[];
+    assumptions: string[];
+    raw: string;
+}, {
+    recommendation: string;
+    confidence: number;
+    reasoning: string;
+    risks: string[];
+    dissent: string[];
+    validationGates: string[];
+    assumptions: string[];
+    raw: string;
+}>;
+type Synthesis = z.infer<typeof SynthesisSchema>;
+interface Synthesizer {
+    synthesize(config: DeliberationConfig, messages: DeliberationMessage[], provider: LLMProvider): Promise<Synthesis>;
+}
+declare const DeliberationMessageSchema: z.ZodObject<{
+    participantId: z.ZodString;
+    participantName: z.ZodString;
+    round: z.ZodNumber;
+    content: z.ZodString;
+    timestamp: z.ZodDate;
+    tokenCount: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input: number;
+        output: number;
+    }, {
+        input: number;
+        output: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    participantId: string;
+    participantName: string;
+    round: number;
+    content: string;
+    timestamp: Date;
+    tokenCount: {
+        input: number;
+        output: number;
+    };
+}, {
+    participantId: string;
+    participantName: string;
+    round: number;
+    content: string;
+    timestamp: Date;
+    tokenCount: {
+        input: number;
+        output: number;
+    };
+}>;
+type DeliberationMessage = z.infer<typeof DeliberationMessageSchema>;
+declare const DeliberationConfigSchema: z.ZodObject<{
+    topic: z.ZodString;
+    options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    context: z.ZodOptional<z.ZodString>;
+    preferredOption: z.ZodOptional<z.ZodString>;
+    participants: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        provider: z.ZodString;
+        model: z.ZodString;
+        systemPrompt: z.ZodString;
+        temperature: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        provider: string;
+        model: string;
+        systemPrompt: string;
+        temperature?: number | undefined;
+    }, {
+        id: string;
+        name: string;
+        provider: string;
+        model: string;
+        systemPrompt: string;
+        temperature?: number | undefined;
+    }>, "many">;
+    rounds: z.ZodDefault<z.ZodNumber>;
+    tokenBudget: z.ZodOptional<z.ZodObject<{
+        perResponse: z.ZodOptional<z.ZodNumber>;
+        total: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        perResponse?: number | undefined;
+        total?: number | undefined;
+    }, {
+        perResponse?: number | undefined;
+        total?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    participants: {
+        id: string;
+        name: string;
+        provider: string;
+        model: string;
+        systemPrompt: string;
+        temperature?: number | undefined;
+    }[];
+    rounds: number;
+    options?: string[] | undefined;
+    context?: string | undefined;
+    preferredOption?: string | undefined;
+    tokenBudget?: {
+        perResponse?: number | undefined;
+        total?: number | undefined;
+    } | undefined;
+}, {
+    topic: string;
+    participants: {
+        id: string;
+        name: string;
+        provider: string;
+        model: string;
+        systemPrompt: string;
+        temperature?: number | undefined;
+    }[];
+    options?: string[] | undefined;
+    context?: string | undefined;
+    preferredOption?: string | undefined;
+    rounds?: number | undefined;
+    tokenBudget?: {
+        perResponse?: number | undefined;
+        total?: number | undefined;
+    } | undefined;
+}>;
+type DeliberationConfig = z.infer<typeof DeliberationConfigSchema>;
+declare const DeliberationMetadataSchema: z.ZodObject<{
+    totalTokens: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input: number;
+        output: number;
+    }, {
+        input: number;
+        output: number;
+    }>;
+    durationMs: z.ZodNumber;
+    modelBreakdown: z.ZodRecord<z.ZodString, z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input: number;
+        output: number;
+    }, {
+        input: number;
+        output: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+    modelBreakdown: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}, {
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+    modelBreakdown: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}>;
+type DeliberationMetadata = z.infer<typeof DeliberationMetadataSchema>;
+interface DeliberationResult {
+    config: DeliberationConfig;
+    messages: DeliberationMessage[];
+    synthesis: Synthesis;
+    metadata: DeliberationMetadata;
+}
+type CouncilEvents = {
+    'round:start': {
+        round: number;
+        participantCount: number;
+    };
+    response: DeliberationMessage;
+    'synthesis:start': undefined;
+    complete: DeliberationResult;
+    error: Error;
+};
+
+interface CouncilOptions {
+    providers: Map<string, LLMProvider>;
+    protocol: Protocol;
+    synthesizer: Synthesizer;
+    synthesisProvider?: {
+        providerId: string;
+        model: string;
+    };
+}
+declare class Council {
+    private providers;
+    private protocol;
+    private synthesizer;
+    private synthesisProvider;
+    private emitter;
+    constructor(options: CouncilOptions);
+    on<K extends keyof CouncilEvents>(event: K, handler: (payload: CouncilEvents[K]) => void): void;
+    off<K extends keyof CouncilEvents>(event: K, handler: (payload: CouncilEvents[K]) => void): void;
+    deliberate(rawConfig: DeliberationConfig): Promise<DeliberationResult>;
+}
+
+interface AnthropicProviderConfig {
+    apiKey: string;
+    defaultModel?: string;
+    defaultMaxTokens?: number;
+}
+declare class AnthropicProvider implements LLMProvider {
+    readonly id: "anthropic";
+    private client;
+    private defaultModel;
+    private defaultMaxTokens;
+    constructor(config: AnthropicProviderConfig);
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+}
+
+interface OpenRouterProviderConfig {
+    apiKey: string;
+    appName?: string;
+    defaultModel?: string;
+    defaultMaxTokens?: number;
+    siteUrl?: string;
+}
+declare class OpenRouterProvider implements LLMProvider {
+    readonly id: "openrouter";
+    private readonly apiKey;
+    private readonly appName;
+    private readonly defaultModel;
+    private readonly defaultMaxTokens;
+    private readonly siteUrl;
+    constructor(config: OpenRouterProviderConfig);
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+}
+
+interface AdversarialProtocolOptions {
+    rebuttalGuidance?: Record<string, string>;
+}
+declare class AdversarialProtocol implements Protocol {
+    private readonly rebuttalGuidance;
+    constructor(options?: AdversarialProtocolOptions);
+    getRoundCount(): number;
+    buildPrompts(config: DeliberationConfig, history: DeliberationMessage[], round: number): PromptRequest[];
+    private buildInitialBriefs;
+    private buildRebuttals;
+}
+
+interface PeerReviewProtocolOptions {
+    enableRevote?: boolean;
+}
+declare class PeerReviewProtocol implements Protocol {
+    private readonly enableRevote;
+    constructor(options?: PeerReviewProtocolOptions);
+    getRoundCount(): number;
+    buildPrompts(config: DeliberationConfig, history: DeliberationMessage[], round: number): PromptRequest[];
+    private buildInitialBriefs;
+    private buildRankingRound;
+    private buildRevoteRound;
+}
+
+interface ChairmanSynthesizerOptions {
+    model?: string;
+    temperature?: number;
+}
+declare class ChairmanSynthesizer implements Synthesizer {
+    private readonly model;
+    private readonly temperature;
+    constructor(options?: ChairmanSynthesizerOptions);
+    synthesize(config: DeliberationConfig, messages: DeliberationMessage[], provider: LLMProvider): Promise<Synthesis>;
+}
+
+interface DialecticalSynthesizerOptions {
+    model?: string;
+    temperature?: number;
+}
+declare class DialecticalSynthesizer implements Synthesizer {
+    private readonly model;
+    private readonly temperature;
+    constructor(options?: DialecticalSynthesizerOptions);
+    synthesize(config: DeliberationConfig, messages: DeliberationMessage[], provider: LLMProvider): Promise<Synthesis>;
+}
+
+type PersonaPreset = Omit<Participant, 'provider' | 'model'>;
+declare const PERSONAS: {
+    readonly proposer: PersonaPreset;
+    readonly challenger: PersonaPreset;
+    readonly steelmanner: PersonaPreset;
+    readonly preMortem: PersonaPreset;
+};
+type PersonaId = keyof typeof PERSONAS;
+
+interface AnonymizationMap {
+    labelToParticipant: Map<string, string>;
+    participantToLabel: Map<string, string>;
+}
+declare function createAnonymizationMap(participantIds: string[]): AnonymizationMap;
+declare function anonymizeMessages(messages: DeliberationMessage[], map: AnonymizationMap): Array<{
+    label: string;
+    content: string;
+}>;
+declare function deanonymizeLabel(label: string, map: AnonymizationMap): string | undefined;
+
+declare function buildInitialUserMessage(config: DeliberationConfig): string;
+
+declare function buildSynthesisUserMessage(config: DeliberationConfig, messages: DeliberationMessage[]): string;
+declare function parseSynthesisResponse(raw: string): Synthesis;
+
+export { AdversarialProtocol, type AnonymizationMap, AnthropicProvider, ChairmanSynthesizer, type CompletionRequest, type CompletionResponse, Council, type CouncilEvents, type CouncilOptions, type DeliberationConfig, DeliberationConfigSchema, type DeliberationMessage, DeliberationMessageSchema, type DeliberationMetadata, DeliberationMetadataSchema, type DeliberationResult, DialecticalSynthesizer, type LLMProvider, OpenRouterProvider, PERSONAS, type Participant, ParticipantSchema, PeerReviewProtocol, type PersonaId, type PromptRequest, type Protocol, type Synthesis, SynthesisSchema, type Synthesizer, anonymizeMessages, buildInitialUserMessage, buildSynthesisUserMessage, createAnonymizationMap, deanonymizeLabel, parseSynthesisResponse };