konsilio 0.3.0

package/LICENSE.md

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -0,0 +1,170 @@
+# Konsilio
+
+**Council of Experts** — an MCP server that runs draft plans through a multi-persona architectural review before you write a single line of code.
+
+## TL;DR
+
+Konsilio lets you run a draft plan through a panel of AI experts (security, performance, DevOps, etc.) before writing code.
+
+It returns a structured blueprint so your coding model can implement it cleanly in one pass.
+
+## The Problem
+
+You're mid-task and realize you need a plan: *"Why is this code not working? We need more logs → logging should be added → let me write a proposal for logging."*
+
+You could feed that plan directly into a coding model and hope it gets it right. Or you could catch blind spots early by having specialists review it first.
+
+## The Solution
+
+Konsilio implements a **multi-stage consulting pipeline**:
+
+1. **Write a proposal** — a short document describing what you want to build or change
+2. **Feed it to the Council** — multiple expert personas (security, performance, DevOps, testing, etc.) review the plan in parallel, each from their own angle
+3. **4-phase consolidation** — a lead agent extracts claims, critiques contradictions, makes accept/reject decisions, and synthesizes a final blueprint
+4. **Implement with a clean slate** — hand the blueprint to a coding-focused model. It starts with empty context and executes the plan in one pass
+
+**Rinse. Repeat. Rewind Selectah!**
+
+## Usage
+
+```bash
+# Install
+npm install -g konsilio
+
+# Configure (edit konsilio.json with your personas and models)
+# Set OPENROUTER_API_KEY in your environment
+
+# Use via MCP in your AI coding tool
+# Tool: consult_council
+# Params: draft_plan, tech_stack (optional), context_constraints (optional)
+```
+
+### Example
+
+```json
+{
+  "draft_plan": "Add structured logging to all API endpoints with correlation IDs",
+  "tech_stack": "Node.js, Express, Pino, PostgreSQL",
+  "context_constraints": "Must run on Proxmox LXC, no external dependencies"
+}
+```
+
+Returns a blueprint with architecture directives, edge cases, constraints, and numbered next steps.
+
+## Configuration
+
+```json
+{
+  "personas": {
+    "enabled": ["security", "performance", "devops", "test-architect"]
+  },
+  "models": {
+    "experts": "google/gemini-2.5-flash-lite",
+    "lead": "google/gemini-2.5-pro"
+  }
+}
+```
+
+Default personas: `security`, `performance`, `ux-dx`, `devops`, `typescript`, `graph-dba`, `node-fullstack`, `dev-tooling`, `distributed-systems`, `test-architect`
+
+```mermaid
+flowchart TD
+    A[Identify Need During Development] --> B[Write Proposal Document]
+    B --> C[Submit to Konsilio Council]
+    
+    subgraph Council["Council Review (Parallel)"]
+        C --> E1[🔒 Security Expert]
+        C --> E2[⚡ Performance Expert]
+        C --> E3[🚀 DevOps Expert]
+        C --> E4[🧪 Test Architect]
+        C --> E5[🎨 UX/DX Expert]
+        C --> E6[🛠️ Dev Tooling Expert]
+    end
+    
+    E1 --> F[Prose Reports]
+    E2 --> F
+    E3 --> F
+    E4 --> F
+    E5 --> F
+    E6 --> F
+    
+    F --> G[Formatter: prose → structured JSON]
+    
+    subgraph Consolidation["4-Phase Consolidation"]
+        G --> H1[📋 Extraction Lead<br/>Extract all claims]
+        H1 --> H2[🔍 Critique Lead<br/>Find contradictions]
+        H2 --> H3[⚖️ Decision Lead<br/>Accept/Reject findings]
+        H3 --> H4[📝 Synthesis Lead<br/>Assemble blueprint]
+    end
+    
+    H4 --> I[Final Blueprint<br/>with edge cases, constraints, next steps]
+    I --> J[Hand to Coding Model<br/>Clean slate, empty context]
+    J --> K[Implement in One Pass]
+    
+    style Council fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
+    style Consolidation fill:#fff8f0,stroke:#f7a44a,stroke-width:2px
+    style I fill:#e8f5e9,stroke:#4caf50,stroke-width:2px
+```
+
+## Architecture
+
+### Expert Personas
+
+Each expert is a focused agent with a specific lens:
+
+| Persona | Focus |
+|---------|-------|
+| 🔒 Security | Auth, injection, rate limiting, data exposure |
+| ⚡ Performance | Bottlenecks, caching, query patterns, scaling |
+| 🚀 DevOps | Deployment, observability, infrastructure |
+| 🧪 Test Architect | Coverage, edge cases, testability |
+| 🎨 UX/DX | API design, developer experience, ergonomics |
+| 🛠️ Dev Tooling | Build pipeline, linting, CI/CD |
+
+Experts output **prose** — free-form analysis without JSON constraints.
+**Note:** User-defined experts can be created by adding an `expert.md` file to `/data/personas/`
+
+### The Lead
+
+The lead agent runs a 4-phase consolidation pipeline:
+
+1. **Extraction** — pulls all claims from expert reports into a unified list
+2. **Critique** — identifies contradictions, unsupported claims, and gaps
+3. **Decision** — explicitly accepts or rejects each finding
+4. **Synthesis** — assembles accepted findings into a coherent blueprint
+
+### The Formatter
+
+A dedicated `gpt-4o-mini` instance converts expert prose to structured JSON using OpenAI's `response_format` feature. This keeps experts focused on analysis, not syntax.
+
+## Why This Works
+
+### 1. Specialized Experts Outperform Generalists
+
+A council of focused expert agents, each primed with a specific role, surfaces more issues at lower cost than a single frontier model:
+
+- **Chan et al. (2023)** — *"ChatEval: Towards Better LLM-based Evaluators through Multi-Agent Debate"* — showed that multiple role-conditioned agents debating produces more accurate evaluations than a single powerful model. [arXiv:2308.07201](https://arxiv.org/abs/2308.07201)
+
+- **Du et al. (2023)** — *"Improving Factuality and Reasoning in Language Models through Multiagent Debate"* — demonstrated that multi-agent debate significantly improves accuracy over single-model inference, with agents catching each other's errors. [arXiv:2305.14325](https://arxiv.org/abs/2305.14325)
+
+- **Liang et al. (2023)** — *"Ensemble Learning for Large Language Models"* — found that combining multiple specialized models outperforms a single large model on complex tasks while using fewer total tokens. [arXiv:2305.07881](https://arxiv.org/abs/2305.07881)
+
+### 2. Separation of Analysis and Formatting
+
+When a model is asked to return structured data directly, its reasoning quality degrades. Konsilio solves this by having experts write **prose first**, then using a dedicated formatter:
+
+- **Dhuliawala et al. (2023)** — *"Chain-of-Verification Reduces Hallucination in Large Language Models"* — demonstrates that separating generation from verification significantly reduces errors. This is the core principle behind Konsilio's two-stage design. [arXiv:2309.11495](https://arxiv.org/abs/2309.11495)
+
+- **Willison et al. (2023)** — *"Jsonformer: A Bulletproof Way to Generate Structured JSON from Language Models"* — documents how JSON schema constraints during generation interfere with reasoning quality, recommending a two-stage approach: generate content freely, then format. [arXiv:2305.15087](https://arxiv.org/abs/2305.15087)
+
+- **Su et al. (2024)** — *"The Impact of Reasoning Step Length on Large Language Models"* — shows that adding structural constraints (like JSON output requirements) during reasoning reduces the model's ability to explore solution spaces, increasing error rates. [arXiv:2401.04991](https://arxiv.org/abs/2401.04991)
+
+This is why Konsilio uses `gpt-4o-mini` as a **dedicated formatter** — it converts prose to JSON without the expert models having to juggle both reasoning and formatting simultaneously.
+
+### 3. Clean-Slate Implementation
+
+By separating planning from execution, the coding model starts with **zero context overhead**. It receives a complete blueprint and executes — no need to re-derive the plan or carry forward the reasoning history. This reduces token costs and avoids context-window pollution.
+
+# License
+
+This software is released under the Unlicense: do whatever you want with it.

package/build/cli/history.d.ts

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

package/build/cli/history.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+import initSqlJs from "sql.js";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+const DB_PATH = resolve(process.cwd(), "data/konsilio.db");
+async function getDatabase() {
+    if (!existsSync(DB_PATH))
+        return null;
+    const SQL = await initSqlJs({
+        locateFile: (file) => `https://sql.js.org/dist/${file}`
+    });
+    const buffer = readFileSync(DB_PATH);
+    return new SQL.Database(buffer);
+}
+function mapRow(columns, values) {
+    const row = {};
+    for (let i = 0; i < columns.length; i++) {
+        row[columns[i]] = values[i];
+    }
+    return row;
+}
+function listSessions(db, limit = 10) {
+    const result = db.exec(`
+    SELECT id, created_at, draft_plan_summary, tech_stack
+    FROM sessions
+    ORDER BY created_at DESC
+    LIMIT ${limit}
+  `);
+    if (result.length === 0 || result[0].values.length === 0) {
+        console.log("No sessions found.");
+        return;
+    }
+    const sessions = result[0].values.map(v => mapRow(result[0].columns, v));
+    console.log("\n╭──────────────────────────────────────────────────────────────╮");
+    console.log("│ 📋 Council Sessions                                           │");
+    console.log("├──────────────────────────────────────────────────────────────┤");
+    for (const s of sessions) {
+        const id = s.id.slice(0, 8);
+        const date = new Date(s.created_at).toLocaleString();
+        const summary = s.draft_plan_summary?.slice(0, 50) ?? "No summary";
+        // Get expert count and total time
+        const statsResult = db.exec(`
+      SELECT COUNT(*) as count, SUM(duration_ms) as total_ms
+      FROM expert_findings
+      WHERE session_id = '${s.id.replace(/'/g, "''")}'
+    `);
+        let stats = { count: 0, total_ms: null };
+        if (statsResult.length > 0 && statsResult[0].values.length > 0) {
+            const row = mapRow(statsResult[0].columns, statsResult[0].values[0]);
+            stats = { count: Number(row.count), total_ms: row.total_ms };
+        }
+        const totalSec = stats.total_ms ? (stats.total_ms / 1000).toFixed(1) : "?";
+        console.log(`│ ${id}… | ${date} | ${stats.count} experts | ${totalSec}s`);
+        console.log(`│   Plan: ${summary}…`);
+        if (s.tech_stack) {
+            console.log(`│   Stack: ${s.tech_stack}`);
+        }
+        console.log("│");
+    }
+    console.log("├──────────────────────────────────────────────────────────────┤");
+    console.log("│ Run `npm run history <session-id>` for full details         │");
+    console.log("╰──────────────────────────────────────────────────────────────╯\n");
+}
+function showSession(db, sessionId) {
+    const escapedId = sessionId.replace(/'/g, "''");
+    // Get session
+    const sessionResult = db.exec(`
+    SELECT * FROM sessions WHERE id = '${escapedId}' OR id LIKE '${escapedId}%'
+  `);
+    if (sessionResult.length === 0 || sessionResult[0].values.length === 0) {
+        console.log(`❌ Session not found: ${sessionId}`);
+        return;
+    }
+    const session = mapRow(sessionResult[0].columns, sessionResult[0].values[0]);
+    const fullId = session.id;
+    const date = new Date(session.created_at).toLocaleString();
+    console.log("\n╭──────────────────────────────────────────────────────────────╮");
+    console.log(`│ 📋 Session: ${session.id}           │`);
+    console.log("├──────────────────────────────────────────────────────────────┤");
+    console.log(`│ 📅 ${date}`);
+    if (session.tech_stack) {
+        console.log(`│ 🔧 Stack: ${session.tech_stack}`);
+    }
+    if (session.constraints) {
+        console.log(`│ ⚠️ Constraints: ${session.constraints}`);
+    }
+    console.log("├──────────────────────────────────────────────────────────────┤");
+    console.log("│ 📝 Draft Plan:");
+    console.log("│");
+    // Get user message (draft plan)
+    const userMsgResult = db.exec(`
+    SELECT content FROM messages
+    WHERE session_id = '${escapedId}' AND role = 'user'
+    ORDER BY created_at ASC LIMIT 1
+  `);
+    if (userMsgResult.length > 0 && userMsgResult[0].values.length > 0) {
+        const userMsg = userMsgResult[0].values[0][0];
+        for (const line of userMsg.split("\n")) {
+            console.log(`│   ${line}`);
+        }
+    }
+    // Get expert findings grouped by persona
+    const findingsResult = db.exec(`
+    SELECT * FROM expert_findings
+    WHERE session_id = '${escapedId}'
+    ORDER BY persona_id, severity
+  `);
+    const findings = [];
+    if (findingsResult.length > 0) {
+        for (const values of findingsResult[0].values) {
+            findings.push(mapRow(findingsResult[0].columns, values));
+        }
+    }
+    console.log("├──────────────────────────────────────────────────────────────┤");
+    console.log("│ 🧠 Expert Findings:");
+    console.log("│");
+    // Group by persona
+    const byPersona = new Map();
+    for (const f of findings) {
+        const existing = byPersona.get(f.persona_id) ?? [];
+        existing.push(f);
+        byPersona.set(f.persona_id, existing);
+    }
+    for (const [personaId, personaFindings] of byPersona) {
+        const emoji = personaFindings[0]?.persona_emoji ?? "👤";
+        const name = personaFindings[0]?.persona_name ?? personaId;
+        console.log(`│ ${emoji} ${name}`);
+        console.log("│ ───────────────────────────────────────────");
+        for (const f of personaFindings) {
+            const status = f.accepted ? "✅" : "❌";
+            console.log(`│   ${status} [${f.severity}] ${f.component}`);
+            console.log(`│      Issue: ${f.issue.slice(0, 60)}${f.issue.length > 60 ? "…" : ""}`);
+            console.log(`│      Fix: ${f.mitigation.slice(0, 60)}${f.mitigation.length > 60 ? "…" : ""}`);
+        }
+        console.log("│");
+    }
+    // Final blueprint (from consolidation phase)
+    const blueprintResult = db.exec(`
+    SELECT content FROM messages
+    WHERE session_id = '${escapedId}' AND role = 'assistant' AND persona_id = 'consolidation'
+    ORDER BY created_at DESC LIMIT 1
+  `);
+    if (blueprintResult.length > 0 && blueprintResult[0].values.length > 0) {
+        const blueprint = blueprintResult[0].values[0][0];
+        console.log("├──────────────────────────────────────────────────────────────┤");
+        console.log("│ 👑 Council Blueprint:");
+        console.log("│");
+        for (const line of blueprint.split("\n")) {
+            console.log(`│   ${line}`);
+        }
+    }
+    console.log("╰──────────────────────────────────────────────────────────────╯\n");
+}
+// Main
+async function main() {
+    const args = process.argv.slice(2);
+    const db = await getDatabase();
+    if (!db) {
+        console.log("❌ No database found at ./data/konsilio.db");
+        console.log("   Run a council session first to create data.");
+        process.exit(1);
+    }
+    try {
+        if (args.length === 0) {
+            listSessions(db);
+        }
+        else {
+            showSession(db, args[0]);
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=history.js.map

package/build/cli/history.js.map

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

package/build/config.d.ts

@@ -0,0 +1,38 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type NodeEnv = "development" | "production" | "test";
+export declare const config: {
+    readonly port: number;
+    readonly openrouterApiKey: string;
+    readonly openrouterBaseUrl: "https://openrouter.ai/api/v1";
+    readonly nodeEnv: NodeEnv;
+    readonly logLevel: LogLevel;
+    readonly isProduction: boolean;
+    readonly isDevelopment: boolean;
+    readonly enabledPersonas: string[] | undefined;
+    readonly models: {
+        readonly experts: string;
+        readonly lead: string;
+        readonly formatter: string;
+    };
+    readonly personaModels: Record<string, string>;
+    readonly timeouts: {
+        readonly expertMs: number;
+        readonly leadMs: number;
+        readonly formatterMs: number;
+    };
+    readonly formatterMaxRetries: number;
+    readonly maxTokens: {
+        readonly experts: number;
+        readonly lead: number;
+    };
+    readonly maxDraftPlanLength: number;
+    readonly maxHistorySessions: number;
+    readonly maxParallelExperts: 4;
+    readonly databasePath: string;
+    readonly cacheTtlSeconds: number;
+};
+/**
+ * Validates that required configuration is present.
+ * Throws an error if required config is missing.
+ */
+export declare function validateConfig(): void;

package/build/config.js

@@ -0,0 +1,118 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ─── CLI Args Parsing ───
+// Parse CLI args: --api-key=xxx
+function parseCliArgs() {
+    const args = {};
+    for (const arg of process.argv.slice(2)) {
+        if (arg.startsWith("--api-key=")) {
+            args.OPENROUTER_API_KEY = arg.slice("--api-key=".length);
+        }
+    }
+    return args;
+}
+const cliArgs = parseCliArgs();
+// Priority: CLI args > process.env > fallback
+function env(key, fallback) {
+    return cliArgs[key] ?? process.env[key] ?? fallback;
+}
+// ─── Validators ───
+function parseLogLevel(value) {
+    const validLevels = ["debug", "info", "warn", "error"];
+    const level = (value ?? "info").toLowerCase();
+    return validLevels.includes(level) ? level : "info";
+}
+function parseNodeEnv(value) {
+    const validEnvs = ["development", "production", "test"];
+    const envValue = (value ?? "development").toLowerCase();
+    return validEnvs.includes(envValue) ? envValue : "development";
+}
+function parsePositiveInt(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : defaultValue;
+}
+function loadKonsilioConfig() {
+    // Search order: project root first, then package directory
+    // This allows consuming projects to override package defaults
+    const candidates = [
+        resolve(process.cwd(), "konsilio.json"), // Project root (consuming project)
+        resolve(__dirname, "..", "konsilio.json"), // Package directory (defaults)
+    ];
+    for (const configPath of candidates) {
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const content = readFileSync(configPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            // Invalid JSON, continue to next candidate
+        }
+    }
+    return {};
+}
+const konsilioConfig = loadKonsilioConfig();
+// ─── Exported Config ───
+export const config = {
+    // Server Configuration
+    port: parsePositiveInt(env("PORT"), 3000),
+    // API Configuration
+    openrouterApiKey: env("OPENROUTER_API_KEY") ?? "",
+    openrouterBaseUrl: "https://openrouter.ai/api/v1",
+    // Environment & Logging
+    nodeEnv: parseNodeEnv(env("NODE_ENV")),
+    logLevel: parseLogLevel(env("LOG_LEVEL")),
+    isProduction: parseNodeEnv(env("NODE_ENV")) === "production",
+    isDevelopment: parseNodeEnv(env("NODE_ENV")) === "development",
+    // Enabled persona IDs from config file (defaults to all if not specified)
+    enabledPersonas: konsilioConfig.personas?.enabled,
+    // Model Configuration
+    models: {
+        experts: konsilioConfig.models?.experts ?? "google/gemini-2.5-flash-lite",
+        lead: konsilioConfig.models?.lead ?? "google/gemini-2.5-pro",
+        formatter: konsilioConfig.models?.formatter ?? "openai/gpt-4o-mini",
+    },
+    // Persona-level model defaults (personaId -> model)
+    personaModels: konsilioConfig.personaModels ?? {},
+    // Timeout Configuration
+    timeouts: {
+        expertMs: konsilioConfig.timeouts?.expertMs ?? 90_000,
+        leadMs: konsilioConfig.timeouts?.leadMs ?? 120_000,
+        formatterMs: konsilioConfig.timeouts?.formatterMs ?? 30_000,
+    },
+    // Formatter retries
+    formatterMaxRetries: konsilioConfig.formatter?.maxRetries ?? 3,
+    // Token limits
+    maxTokens: {
+        experts: konsilioConfig.maxTokens?.experts ?? 4096,
+        lead: konsilioConfig.maxTokens?.lead ?? 16384,
+    },
+    // Limits
+    maxDraftPlanLength: konsilioConfig.maxDraftPlanLength ?? 12000,
+    maxHistorySessions: konsilioConfig.maxHistorySessions ?? 10,
+    maxParallelExperts: 4,
+    // Database & Caching
+    databasePath: konsilioConfig.databasePath ?? "./data/konsilio.db",
+    cacheTtlSeconds: konsilioConfig.cacheTtlSeconds ?? 3600,
+};
+// ─── Validation ───
+/**
+ * Validates that required configuration is present.
+ * Throws an error if required config is missing.
+ */
+export function validateConfig() {
+    if (!config.openrouterApiKey) {
+        throw new Error("Missing OPENROUTER_API_KEY. Set it via OPENROUTER_API_KEY environment variable.\n" +
+            "Get your key at https://openrouter.ai/keys");
+    }
+    if (!config.enabledPersonas || config.enabledPersonas.length === 0) {
+        throw new Error("Missing enabled personas in konsilio.json. " +
+            "Add a 'personas.enabled' array with valid persona IDs. " +
+            "Available: security, performance, ux-dx, devops, typescript, graph-dba, node-fullstack, dev-tooling, distributed-systems, test-architect");
+    }
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

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

package/build/container.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 { 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';
+export interface AppServices {
+    openRouterService: OpenRouterService;
+    databaseService: DatabaseService;
+    cacheService: CacheService;
+    promptService: PromptService;
+    personaService: PersonaService;
+    councilService: CouncilService;
+}
+/**
+ * Create and wire up all application services (async)
+ */
+export declare function createServices(): Promise<AppServices>;
+/**
+ * Get the singleton services instance (returns a Promise)
+ */
+export declare function getServices(): Promise<AppServices>;
+/**
+ * Reset services (useful for testing)
+ */
+export declare function resetServices(): void;