konsilio 0.3.0

package/build/container.js

@@ -0,0 +1,102 @@
+/**
+ * Dependency Injection Container
+ *
+ * Composition root that wires up all services with their dependencies.
+ * This is the single place where all dependencies are created and connected.
+ */
+import { logger } from './logger.js';
+import { config, validateConfig } from './config.js';
+import { SCHEMA } from './db/schema.js';
+import { OpenRouterService } from './services/openrouter.service.js';
+import { DatabaseService } from './services/database.service.js';
+import { CacheService } from './services/cache.service.js';
+import { PromptService } from './services/prompt.service.js';
+import { PersonaService } from './services/persona.service.js';
+import { CouncilService } from './services/council.service.js';
+import { FormatterService } from './services/formatter.service.js';
+/**
+ * Create and wire up all application services (async)
+ */
+export async function createServices() {
+    // Validate configuration before creating services
+    validateConfig();
+    // Create OpenRouter service
+    const openRouterService = new OpenRouterService({
+        apiKey: config.openrouterApiKey,
+        baseUrl: config.openrouterBaseUrl,
+    }, logger);
+    // Create Database service (async factory due to WASM loading)
+    const databaseService = await DatabaseService.create({
+        dbPath: config.databasePath,
+        maxHistorySessions: config.maxHistorySessions,
+    }, logger, SCHEMA);
+    // Create Cache service
+    const cacheService = new CacheService(config.cacheTtlSeconds * 1000);
+    // Create Prompt service
+    const promptService = new PromptService(undefined, logger);
+    // Create Persona service
+    const personaService = new PersonaService({
+        promptService,
+        cacheService,
+        logger,
+    });
+    // Create Council service with all dependencies
+    const councilConfig = {
+        enabledPersonaIds: config.enabledPersonas,
+        models: config.models,
+        personaModels: config.personaModels,
+        timeouts: config.timeouts,
+        maxTokens: config.maxTokens,
+        maxDraftPlanLength: config.maxDraftPlanLength,
+        formatterMaxRetries: config.formatterMaxRetries,
+    };
+    // Create Formatter service
+    const formatterConfig = {
+        model: config.models.formatter,
+        timeoutMs: config.timeouts.formatterMs,
+        maxRetries: config.formatterMaxRetries,
+    };
+    const formatterService = new FormatterService({
+        openRouterService,
+        logger,
+        config: formatterConfig,
+    });
+    const councilService = new CouncilService({
+        logger,
+        openRouterService,
+        databaseService,
+        cacheService,
+        promptService,
+        personaService,
+        formatterService,
+        config: councilConfig,
+    });
+    return {
+        openRouterService,
+        databaseService,
+        cacheService,
+        promptService,
+        personaService,
+        councilService,
+    };
+}
+/**
+ * Singleton services instance (lazy initialized)
+ */
+let _services = null;
+/**
+ * Get the singleton services instance (returns a Promise)
+ */
+export function getServices() {
+    if (!_services) {
+        _services = createServices();
+    }
+    return _services;
+}
+/**
+ * Reset services (useful for testing)
+ */
+export function resetServices() {
+    _services = null;
+}
+//# sourceMappingURL=container.js.map

package/build/container.js.map

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

package/build/db/schema.d.ts

@@ -0,0 +1 @@
+export declare const SCHEMA = "\nCREATE TABLE IF NOT EXISTS sessions (\n  id TEXT PRIMARY KEY,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  draft_plan_summary TEXT,\n  tech_stack TEXT,\n  constraints TEXT\n);\n\nCREATE TABLE IF NOT EXISTS messages (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  role TEXT NOT NULL CHECK(role IN ('user', 'assistant')),\n  persona_id TEXT,\n  content TEXT NOT NULL,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS expert_findings (\n  id TEXT PRIMARY KEY,\n  session_id TEXT NOT NULL,\n  persona_id TEXT NOT NULL,\n  persona_name TEXT NOT NULL,\n  persona_emoji TEXT,\n  severity TEXT NOT NULL CHECK(severity IN ('CRITICAL', 'HIGH', 'MEDIUM', 'LOW')),\n  component TEXT NOT NULL,\n  issue TEXT NOT NULL,\n  mitigation TEXT NOT NULL,\n  accepted BOOLEAN DEFAULT 0,\n  rejection_reason TEXT,\n  duration_ms INTEGER,\n  model_used TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS expert_risks (\n  id TEXT PRIMARY KEY,\n  session_id TEXT NOT NULL,\n  persona_id TEXT NOT NULL,\n  category TEXT NOT NULL,\n  probability TEXT NOT NULL,\n  impact TEXT NOT NULL,\n  description TEXT NOT NULL,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS consolidation_phases (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  phase_name TEXT NOT NULL CHECK(phase_name IN ('extraction', 'critique', 'decision', 'synthesis')),\n  phase_output TEXT NOT NULL,\n  duration_ms INTEGER,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n);\n\nCREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);\nCREATE INDEX IF NOT EXISTS idx_findings_session ON expert_findings(session_id);\nCREATE INDEX IF NOT EXISTS idx_findings_accepted ON expert_findings(accepted);\nCREATE INDEX IF NOT EXISTS idx_risks_session ON expert_risks(session_id);\nCREATE INDEX IF NOT EXISTS idx_phases_session ON consolidation_phases(session_id);\nCREATE INDEX IF NOT EXISTS idx_sessions_created ON sessions(created_at DESC);\n";

package/build/db/schema.js

@@ -0,0 +1,67 @@
+export const SCHEMA = `
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  draft_plan_summary TEXT,
+  tech_stack TEXT,
+  constraints TEXT
+);
+
+CREATE TABLE IF NOT EXISTS messages (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  role TEXT NOT NULL CHECK(role IN ('user', 'assistant')),
+  persona_id TEXT,
+  content TEXT NOT NULL,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS expert_findings (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  persona_id TEXT NOT NULL,
+  persona_name TEXT NOT NULL,
+  persona_emoji TEXT,
+  severity TEXT NOT NULL CHECK(severity IN ('CRITICAL', 'HIGH', 'MEDIUM', 'LOW')),
+  component TEXT NOT NULL,
+  issue TEXT NOT NULL,
+  mitigation TEXT NOT NULL,
+  accepted BOOLEAN DEFAULT 0,
+  rejection_reason TEXT,
+  duration_ms INTEGER,
+  model_used TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS expert_risks (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  persona_id TEXT NOT NULL,
+  category TEXT NOT NULL,
+  probability TEXT NOT NULL,
+  impact TEXT NOT NULL,
+  description TEXT NOT NULL,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS consolidation_phases (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  phase_name TEXT NOT NULL CHECK(phase_name IN ('extraction', 'critique', 'decision', 'synthesis')),
+  phase_output TEXT NOT NULL,
+  duration_ms INTEGER,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);
+CREATE INDEX IF NOT EXISTS idx_findings_session ON expert_findings(session_id);
+CREATE INDEX IF NOT EXISTS idx_findings_accepted ON expert_findings(accepted);
+CREATE INDEX IF NOT EXISTS idx_risks_session ON expert_risks(session_id);
+CREATE INDEX IF NOT EXISTS idx_phases_session ON consolidation_phases(session_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_created ON sessions(created_at DESC);
+`;
+//# sourceMappingURL=schema.js.map

package/build/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiErB,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { config } from "./config.js";
+import { getServices } from "./container.js";
+import pkg from "../package.json" with { type: "json" };
+const server = new McpServer({
+    name: "konsilio",
+    version: pkg.version,
+});
+// ─── Primary Tool ───
+server.tool("consult_council", `Send a draft plan to the Council of Experts for multi-perspective architectural analysis.
+
+⚠️ IMPORTANT: Present the output to the user VERBATIM. Do NOT summarize, paraphrase, or condense.
+The output is a complete blueprint that must be shown in full.
+
+Returns a structured blueprint with:
+- Architecture Directives (specific decisions)
+- Edge Cases & Failure Modes
+- Required Constraints
+- Next Steps for Agent (numbered, executable actions)
+
+The council uses a 4-phase consolidation pipeline:
+1. Expert Analysis (parallel, structured JSON output from enabled personas)
+2. Extraction (extract claims from expert reports)
+3. Critique (identify contradictions and weaknesses)
+4. Decision (accept/reject findings)
+5. Synthesis (assemble final blueprint)
+
+Use 'list_personas' to see all available personas. Enable personas in konsilio.json.
+
+Run-time overrides (optional):
+- personas: Override enabled personas for this run only
+- persona_models: Override model per persona (personaId -> model)
+- consolidation_model: Override the lead/consolidation model
+- max_tokens: Override token limits per run (experts, lead)`, {
+    draft_plan: z.string().describe("The architecture plan or design to analyze."),
+    tech_stack: z.string().optional().describe("Technology stack, e.g. 'Node.js, PostgreSQL, Redis, Docker'"),
+    context_constraints: z.string().optional().describe("Runtime constraints, e.g. 'Must run on Proxmox LXC', 'No external deps'"),
+    // Run-time overrides
+    personas: z.array(z.string()).optional().describe("Override enabled personas for this run only. Uses persona IDs from konsilio.json."),
+    persona_models: z.record(z.string(), z.string()).optional().describe("Override model per persona. Maps personaId -> model ID."),
+    consolidation_model: z.string().optional().describe("Override the lead/consolidation model for this run."),
+    max_tokens: z.object({
+        experts: z.number().optional(),
+        lead: z.number().optional(),
+    }).optional().describe("Override token limits for this run. Experts: per-persona max, Lead: consolidation max."),
+}, async (params) => {
+    const draftPlan = params.draft_plan.trim();
+    if (!draftPlan) {
+        return {
+            content: [{ type: "text", text: "❌ Error: draft_plan cannot be empty." }],
+            isError: true,
+        };
+    }
+    if (draftPlan.length > config.maxDraftPlanLength) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ Error: draft_plan too long (${draftPlan.length}/${config.maxDraftPlanLength} chars).`,
+                }],
+            isError: true,
+        };
+    }
+    try {
+        const services = await getServices();
+        const result = await services.councilService.run({
+            draftPlan,
+            techStack: params.tech_stack,
+            contextConstraints: params.context_constraints,
+        }, {
+            personaOverride: params.personas,
+            personaModelsOverride: params.persona_models,
+            consolidationModelOverride: params.consolidation_model,
+            maxTokensOverride: params.max_tokens,
+        });
+        return {
+            content: [{ type: "text", text: result.finalBlueprint }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `❌ Council error: ${msg}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Session History ───
+server.tool("get_session_history", "Retrieve previous council session summaries.", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of sessions to retrieve"),
+}, async (params) => {
+    const services = await getServices();
+    const sessions = services.databaseService.getRecentSessions(params.limit);
+    if (sessions.length === 0) {
+        return { content: [{ type: "text", text: "No previous sessions found." }] };
+    }
+    let output = "# Recent Council Sessions\n\n";
+    for (const s of sessions) {
+        output += `## ${s.id.slice(0, 8)}… (${s.created_at})\n`;
+        if (s.tech_stack)
+            output += `**Stack**: ${s.tech_stack}\n`;
+        if (s.draft_plan_summary)
+            output += `**Plan**: ${s.draft_plan_summary}…\n`;
+        output += "\n";
+    }
+    return { content: [{ type: "text", text: output }] };
+});
+// ─── Persona Listing ───
+server.tool("list_personas", "List all expert personas in the council.", {}, async () => {
+    const services = await getServices();
+    const personaIds = services.personaService.getAvailablePersonaIds();
+    const allPersonas = services.personaService.createExperts(personaIds, 'default');
+    let output = "# Council Personas\n\n";
+    for (const p of allPersonas) {
+        output += `## ${p.emoji} ${p.name}\n`;
+        output += `**ID**: \`${p.id}\`\n`;
+        output += `**Focus**: ${p.focusAreas.join(", ")}\n\n`;
+    }
+    return { content: [{ type: "text", text: output }] };
+});
+// ─── Health Check ───
+server.tool("ping", "Test if Council MCP is running.", {}, async () => ({
+    content: [{
+            type: "text",
+            text: "🏓 Council MCP is running! Use 'consult_council' to get expert analysis.",
+        }],
+}));
+// ─── Start ───
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Konsilio MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/konsilio.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "./konsilio.schema.json",
+  "personas": {
+    "enabled": ["ux-dx", "performance", "node-fullstack", "devops", "dev-tooling", "test-architect"],
+    "_comment": "Available personas: security, performance, ux-dx, devops, typescript, graph-dba, node-fullstack, dev-tooling, distributed-systems, test-architect"
+  },
+  "constitution": "./constitution.txt",
+  "models": {
+    "experts": "google/gemini-2.5-flash-lite",
+    "lead": "google/gemini-2.5-pro"
+  },
+  "personaModels": {},
+  "timeouts": {
+    "expertMs": 90000,
+    "leadMs": 120000
+  },
+  "maxTokens": {
+    "experts": 16384,
+    "lead": 32768
+  },
+  "maxDraftPlanLength": 12000,
+  "maxHistorySessions": 10,
+  "databasePath": "./data/db/konsilio.db",
+  "cacheTtlSeconds": 3600
+}

package/build/konsilio.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Konsilio Configuration",
+  "description": "Configuration file for the Konsilio Council of Experts MCP server",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Path to this JSON schema file for IDE validation"
+    },
+    "personas": {
+      "type": "object",
+      "description": "Persona configuration for expert analysis",
+      "properties": {
+        "enabled": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Persona ID (e.g., security, performance, ux-dx, devops, or custom personas)"
+          },
+          "minItems": 2,
+          "description": "Expert personas to include in council consultations. Must have at least 2. Built-in personas: security, performance, ux-dx, devops, typescript, graph-dba, node-fullstack, dev-tooling, distributed-systems, test-architect"
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
+    },
+    "constitution": {
+      "type": "string",
+      "description": "Path to optional constitution file with custom workflow rules"
+    },
+    "models": {
+      "type": "object",
+      "description": "Default model configuration for all personas",
+      "properties": {
+        "experts": {
+          "type": "string",
+          "description": "Default model for expert personas. Override per-persona with personaModels."
+        },
+        "lead": {
+          "type": "string",
+          "description": "Model for consolidation phases (extraction, critique, decision, synthesis)"
+        },
+        "formatter": {
+          "type": "string",
+          "description": "Model used to format prose into structured JSON"
+        }
+      },
+      "additionalProperties": false
+    },
+    "personaModels": {
+      "type": "object",
+      "description": "Per-persona model defaults. Maps personaId to model ID. Overrides models.experts for specific personas.",
+      "additionalProperties": {
+        "type": "string",
+        "description": "OpenRouter model ID for this persona"
+      },
+      "examples": [
+        {
+          "security": "openai/gpt-4o",
+          "performance": "anthropic/claude-sonnet-4"
+        }
+      ]
+    },
+    "timeouts": {
+      "type": "object",
+      "description": "Timeout configuration for API calls",
+      "properties": {
+        "expertMs": {
+          "type": "integer",
+          "minimum": 10000,
+          "description": "Timeout for expert analysis in milliseconds"
+        },
+        "leadMs": {
+          "type": "integer",
+          "minimum": 30000,
+          "description": "Timeout for consolidation phases in milliseconds"
+        },
+        "formatterMs": {
+          "type": "integer",
+          "minimum": 10000,
+          "description": "Timeout for formatting prose in milliseconds"
+        }
+      },
+      "additionalProperties": false
+    },
+    "maxTokens": {
+      "type": "object",
+      "description": "Token limits for API calls",
+      "properties": {
+        "experts": {
+          "type": "integer",
+          "minimum": 100,
+          "description": "Max tokens per expert analysis"
+        },
+        "lead": {
+          "type": "integer",
+          "minimum": 100,
+          "description": "Max tokens for consolidation phases"
+        }
+      },
+      "additionalProperties": false
+    },
+    "maxDraftPlanLength": {
+      "type": "integer",
+      "minimum": 1000,
+      "description": "Maximum length of draft plan input in characters"
+    },
+    "maxHistorySessions": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "Maximum number of session history entries to retain"
+    },
+    "databasePath": {
+      "type": "string",
+      "description": "Path to SQLite database file for session storage"
+    },
+    "cacheTtlSeconds": {
+      "type": "integer",
+      "minimum": 60,
+      "description": "Cache time-to-live in seconds for persona data"
+    },
+    "formatter": {
+      "type": "object",
+      "description": "Formatter service configuration",
+      "properties": {
+        "maxRetries": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Maximum retries for formatting failures"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["personas"],
+  "additionalProperties": false
+}

package/build/logger.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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';
+import type { LogLevel } from './config.js';
+export type { LogLevel };
+/**
+ * LogWriter interface - standard logging methods
+ * Used for correlated logger instances
+ */
+export interface LogWriter {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Logger interface - extends LogWriter with correlation ID support
+ */
+export interface Logger extends LogWriter {
+    /**
+     * Create a child logger with correlation ID embedded in all logs
+     */
+    withCorrelationId(correlationId: string): CorrelatedLogger;
+    /**
+     * Debug with optional correlation ID (backward compatibility)
+     */
+    debug(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    /**
+     * Info with optional correlation ID (backward compatibility)
+     */
+    info(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    /**
+     * Warn with optional correlation ID (backward compatibility)
+     */
+    warn(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    /**
+     * Error with optional correlation ID (backward compatibility)
+     */
+    error(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+}
+/**
+ * CorrelatedLogger - logger that automatically includes correlation ID
+ */
+export interface CorrelatedLogger extends LogWriter {
+}
+/**
+ * Pino-backed Logger implementation
+ */
+declare class PinoLogger implements Logger {
+    protected readonly pino: pino.Logger;
+    constructor(level?: LogLevel);
+    debug(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    info(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    warn(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    error(message: string, data?: Record<string, unknown>, correlationId?: string): void;
+    withCorrelationId(correlationId: string): CorrelatedLogger;
+}
+/**
+ * Singleton logger instance configured from LOG_LEVEL env var
+ */
+export declare const logger: PinoLogger;
+/**
+ * Create a logger instance with the specified log level
+ * @param level - Optional log level (defaults to LOG_LEVEL env var or 'info')
+ */
+export declare function createLogger(level?: LogLevel): Logger;
+/**
+ * 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 declare function getLogger(correlationId: string): CorrelatedLogger;
+export declare const log: {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+};