@gamaze/hicortex 0.2.1 → 0.3.0

package/dist/init.js

@@ -0,0 +1,397 @@
+"use strict";
+/**
+ * Hicortex init — detect existing setup and configure for CC.
+ *
+ * Detection:
+ *   1. Local HC server running (localhost:8787)
+ *   2. Remote HC server (HICORTEX_SERVER_URL or bedrock:8787)
+ *   3. OC plugin installed (~/.openclaw/openclaw.json)
+ *   4. CC MCP already registered (~/.claude/settings.json)
+ *   5. Existing DB (~/.hicortex/ or ~/.openclaw/data/)
+ *
+ * Actions:
+ *   - Install persistent daemon (launchd/systemd)
+ *   - Register MCP server in CC settings
+ *   - Inject CLAUDE.md learnings block
+ *   - Install CC custom commands (/learn, /hicortex-activate)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const node_child_process_1 = require("node:child_process");
+const node_readline_1 = require("node:readline");
+const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
+const CC_COMMANDS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "commands");
+const OC_CONFIG = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "openclaw.json");
+const DEFAULT_PORT = 8787;
+async function detect() {
+    const result = {
+        localServer: false,
+        remoteServer: false,
+        ocPlugin: false,
+        ccMcpRegistered: false,
+        existingDb: false,
+    };
+    // Check local server
+    try {
+        const resp = await fetch(`http://127.0.0.1:${DEFAULT_PORT}/health`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (resp.ok) {
+            result.localServer = true;
+            result.localServerUrl = `http://127.0.0.1:${DEFAULT_PORT}`;
+            const data = await resp.json();
+            result.memoryCount = data.memories;
+        }
+    }
+    catch { /* not running */ }
+    // Check remote server (env var)
+    const remoteUrl = process.env.HICORTEX_SERVER_URL;
+    if (remoteUrl && !result.localServer) {
+        try {
+            const resp = await fetch(`${remoteUrl}/health`, {
+                signal: AbortSignal.timeout(2000),
+            });
+            if (resp.ok) {
+                result.remoteServer = true;
+                result.remoteServerUrl = remoteUrl;
+                const data = await resp.json();
+                result.memoryCount = data.memories;
+            }
+        }
+        catch { /* not reachable */ }
+    }
+    // Check OC plugin
+    try {
+        const raw = (0, node_fs_1.readFileSync)(OC_CONFIG, "utf-8");
+        const config = JSON.parse(raw);
+        const entries = config?.plugins?.entries ?? {};
+        const installs = config?.plugins?.installs ?? {};
+        result.ocPlugin = "hicortex" in entries || "hicortex" in installs || "hicortex-memory" in entries;
+    }
+    catch { /* no OC config */ }
+    // Check CC MCP registration
+    try {
+        const raw = (0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8");
+        const settings = JSON.parse(raw);
+        result.ccMcpRegistered = "hicortex" in (settings?.mcpServers ?? {});
+    }
+    catch { /* no CC settings */ }
+    // Check existing DB
+    const canonicalDb = (0, node_path_1.join)(HICORTEX_HOME, "hicortex.db");
+    const legacyDb = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "data", "hicortex.db");
+    if ((0, node_fs_1.existsSync)(canonicalDb)) {
+        result.existingDb = true;
+        result.dbPath = canonicalDb;
+    }
+    else if ((0, node_fs_1.existsSync)(legacyDb)) {
+        result.existingDb = true;
+        result.dbPath = legacyDb;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Actions
+// ---------------------------------------------------------------------------
+function registerCcMcp(serverUrl) {
+    let settings = {};
+    try {
+        settings = JSON.parse((0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8"));
+    }
+    catch { /* create new */ }
+    if (!settings.mcpServers)
+        settings.mcpServers = {};
+    settings.mcpServers.hicortex = {
+        type: "http",
+        url: `${serverUrl}/sse`,
+    };
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(CC_SETTINGS), { recursive: true });
+    (0, node_fs_1.writeFileSync)(CC_SETTINGS, JSON.stringify(settings, null, 2));
+    console.log(`  ✓ Registered MCP server in ${CC_SETTINGS}`);
+}
+function installCcCommands() {
+    (0, node_fs_1.mkdirSync)(CC_COMMANDS_DIR, { recursive: true });
+    // /learn command
+    const learnContent = `# Save Learning to Hicortex
+
+When invoked with \`/learn <text>\`, store the learning in long-term memory.
+
+## Steps
+
+1. Parse the text after \`/learn\`
+2. Clean it up into a clear, self-contained statement
+3. Add today's date
+4. Call the \`hicortex_ingest\` tool with:
+   - \`content\`: The learning text prefixed with "LEARNING: "
+   - \`project\`: "global" (unless clearly project-specific)
+   - \`memory_type\`: "lesson"
+5. Confirm what was saved (brief, one line)
+`;
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(CC_COMMANDS_DIR, "learn.md"), learnContent);
+    // /hicortex-activate command
+    const activateContent = `# Activate Hicortex License
+
+When the user wants to activate their license key:
+
+## If key provided (e.g. /hicortex-activate hctx-abc123)
+
+Write the key to the config file:
+
+\`\`\`bash
+mkdir -p ~/.hicortex
+cat > ~/.hicortex/config.json << 'EOF'
+{ "licenseKey": "THE_KEY_HERE" }
+EOF
+\`\`\`
+
+Then tell the user: "License activated! Hicortex now has unlimited memory. Restart the server to apply: \`launchctl stop com.gamaze.hicortex && launchctl start com.gamaze.hicortex\`"
+
+## If no key provided
+
+Tell them: "Get a license key at https://hicortex.gamaze.com/ — after purchase, you'll receive your key by email. Then tell me the key and I'll activate it."
+`;
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(CC_COMMANDS_DIR, "hicortex-activate.md"), activateContent);
+    console.log(`  ✓ Installed /learn and /hicortex-activate commands in ${CC_COMMANDS_DIR}`);
+}
+function installDaemon() {
+    const os = (0, node_os_1.platform)();
+    const npxPath = findNpxPath();
+    if (os === "darwin") {
+        return installLaunchd(npxPath);
+    }
+    else if (os === "linux") {
+        return installSystemd(npxPath);
+    }
+    else {
+        console.log(`  ⚠ Unsupported platform: ${os}. Start the server manually: npx @gamaze/hicortex server`);
+        return false;
+    }
+}
+function findNpxPath() {
+    try {
+        return (0, node_child_process_1.execSync)("which npx", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "/usr/local/bin/npx";
+    }
+}
+function installLaunchd(npxPath) {
+    const plistDir = (0, node_path_1.join)((0, node_os_1.homedir)(), "Library", "LaunchAgents");
+    const plistPath = (0, node_path_1.join)(plistDir, "com.gamaze.hicortex.plist");
+    const logPath = (0, node_path_1.join)(HICORTEX_HOME, "server.log");
+    const errLogPath = (0, node_path_1.join)(HICORTEX_HOME, "server-err.log");
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.gamaze.hicortex</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${npxPath}</string>
+    <string>-y</string>
+    <string>@gamaze/hicortex</string>
+    <string>server</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logPath}</string>
+  <key>StandardErrorPath</key>
+  <string>${errLogPath}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${(0, node_path_1.dirname)(npxPath)}:/usr/local/bin:/usr/bin:/bin</string>
+  </dict>
+</dict>
+</plist>`;
+    (0, node_fs_1.mkdirSync)(plistDir, { recursive: true });
+    (0, node_fs_1.mkdirSync)(HICORTEX_HOME, { recursive: true });
+    (0, node_fs_1.writeFileSync)(plistPath, plist);
+    try {
+        // Unload first if already loaded (idempotent)
+        try {
+            (0, node_child_process_1.execSync)(`launchctl unload ${plistPath} 2>/dev/null`);
+        }
+        catch { /* not loaded */ }
+        (0, node_child_process_1.execSync)(`launchctl load ${plistPath}`);
+        console.log(`  ✓ Installed launchd daemon: ${plistPath}`);
+        return true;
+    }
+    catch (err) {
+        console.error(`  ✗ Failed to load launchd plist: ${err}`);
+        return false;
+    }
+}
+function installSystemd(npxPath) {
+    const unitDir = (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "systemd", "user");
+    const servicePath = (0, node_path_1.join)(unitDir, "hicortex.service");
+    const service = `[Unit]
+Description=Hicortex MCP server — long-term memory for AI agents
+
+[Service]
+Type=simple
+ExecStart=${npxPath} -y @gamaze/hicortex server
+Restart=on-failure
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+Environment=PATH=${(0, node_path_1.dirname)(npxPath)}:/usr/local/bin:/usr/bin:/bin
+
+[Install]
+WantedBy=default.target
+`;
+    (0, node_fs_1.mkdirSync)(unitDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(servicePath, service);
+    try {
+        (0, node_child_process_1.execSync)("systemctl --user daemon-reload");
+        (0, node_child_process_1.execSync)("systemctl --user enable --now hicortex.service");
+        console.log(`  ✓ Installed systemd service: ${servicePath}`);
+        return true;
+    }
+    catch (err) {
+        console.error(`  ✗ Failed to enable systemd service: ${err}`);
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Interactive prompt
+// ---------------------------------------------------------------------------
+async function ask(question) {
+    const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function runInit() {
+    console.log("Hicortex — Setup for Claude Code\n");
+    // Phase 1: Detect
+    console.log("Detecting existing setup...\n");
+    const d = await detect();
+    // Phase 2: Report
+    console.log("Found:");
+    if (d.localServer)
+        console.log(`  • Local server running at ${d.localServerUrl} (${d.memoryCount ?? "?"} memories)`);
+    if (d.remoteServer)
+        console.log(`  • Remote server at ${d.remoteServerUrl} (${d.memoryCount ?? "?"} memories)`);
+    if (d.ocPlugin)
+        console.log("  • OpenClaw plugin installed");
+    if (d.ccMcpRegistered)
+        console.log("  • CC MCP already registered");
+    if (d.existingDb)
+        console.log(`  • Database at ${d.dbPath}`);
+    if (!d.localServer && !d.remoteServer && !d.ocPlugin && !d.existingDb) {
+        console.log("  • Fresh install (no existing Hicortex found)");
+    }
+    console.log();
+    // Determine server URL
+    let serverUrl;
+    if (d.localServer) {
+        serverUrl = d.localServerUrl;
+        console.log(`Using existing local server at ${serverUrl}`);
+    }
+    else if (d.remoteServer) {
+        serverUrl = d.remoteServerUrl;
+        console.log(`Using remote server at ${serverUrl}`);
+    }
+    else {
+        serverUrl = `http://127.0.0.1:${DEFAULT_PORT}`;
+        console.log("No running server found. Will install a local daemon.");
+    }
+    console.log();
+    // Phase 2.5: Actions summary
+    const actions = [];
+    if (!d.localServer && !d.remoteServer)
+        actions.push("Install Hicortex server daemon");
+    if (!d.ccMcpRegistered)
+        actions.push("Register MCP server in CC settings");
+    actions.push("Install /learn and /hicortex-activate commands");
+    actions.push("Add Hicortex Learnings block to CLAUDE.md");
+    if (actions.length === 0) {
+        console.log("Everything is already configured. Nothing to do.");
+        return;
+    }
+    console.log("Actions:");
+    actions.forEach((a) => console.log(`  - ${a}`));
+    console.log();
+    const answer = await ask("Continue? [Y/n] ");
+    if (answer.toLowerCase() === "n") {
+        console.log("Cancelled.");
+        return;
+    }
+    console.log();
+    // Phase 3: Execute
+    // Install daemon if needed
+    if (!d.localServer && !d.remoteServer) {
+        installDaemon();
+        // Give daemon a moment to start
+        console.log("  ⏳ Waiting for server to start...");
+        await new Promise((r) => setTimeout(r, 5000));
+        // Verify
+        try {
+            const resp = await fetch(`${serverUrl}/health`, { signal: AbortSignal.timeout(3000) });
+            if (resp.ok) {
+                console.log("  ✓ Server is running");
+            }
+            else {
+                console.log("  ⚠ Server started but health check returned non-200. Check logs at ~/.hicortex/server.log");
+            }
+        }
+        catch {
+            console.log("  ⚠ Server may still be starting. Check: curl http://127.0.0.1:8787/health");
+        }
+    }
+    // Register MCP
+    if (!d.ccMcpRegistered) {
+        registerCcMcp(serverUrl);
+    }
+    // Install CC commands
+    installCcCommands();
+    // Inject CLAUDE.md (only if server has a DB we can read)
+    // For now, just create the block with agent guidance and no lessons
+    // Lessons will populate on first nightly run
+    const claudeMdPath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");
+    if (!(0, node_fs_1.existsSync)(claudeMdPath) || !(0, node_fs_1.readFileSync)(claudeMdPath, "utf-8").includes("HICORTEX-LEARNINGS")) {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(claudeMdPath), { recursive: true });
+        let content = "";
+        try {
+            content = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
+        }
+        catch { /* new file */ }
+        const block = [
+            "<!-- HICORTEX-LEARNINGS:START -->",
+            "## Hicortex Learnings",
+            "",
+            "You have access to long-term memory via Hicortex MCP tools. Use `hicortex_search` when you need context from past sessions, decisions, or prior work. Use `hicortex_context` at session start to recall recent project state. Use `hicortex_ingest` to save important decisions or learnings. Sessions are auto-captured nightly.",
+            "<!-- HICORTEX-LEARNINGS:END -->",
+        ].join("\n");
+        if (content.length > 0 && !content.endsWith("\n"))
+            content += "\n";
+        if (content.length > 0)
+            content += "\n";
+        content += block + "\n";
+        (0, node_fs_1.writeFileSync)(claudeMdPath, content);
+        console.log(`  ✓ Added Hicortex Learnings block to ${claudeMdPath}`);
+    }
+    else {
+        console.log(`  ✓ CLAUDE.md already has Hicortex Learnings block`);
+    }
+    console.log("\n✓ Hicortex setup complete!\n");
+    console.log("Next steps:");
+    console.log("  1. Restart Claude Code to pick up the new MCP server");
+    console.log("  2. Ask your agent: 'What Hicortex tools do you have?'");
+    console.log("  3. Try /learn to save something to long-term memory");
+    console.log(`  4. Check server: curl ${serverUrl}/health`);
+}

package/dist/llm.d.ts

@@ -2,13 +2,20 @@
  * Multi-provider LLM client for consolidation and distillation.
  * Ported from hicortex/consolidate/llm.py.
  *
- * Resolution order for LLM provider:
+ * Resolution for OC adapter (resolveLlmConfig):
  *   1. Plugin config (llmBaseUrl, llmApiKey, llmModel)
  *   2. ~/.openclaw/openclaw.json agents.defaults.model.primary
  *   3. Environment vars: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY
  *   4. Fallback: Ollama at http://localhost:11434
  *
- * Supports: OpenAI, Anthropic (via OpenAI compat), Google, OpenRouter, Ollama, z.ai
+ * Resolution for CC adapter (resolveLlmConfigForCC):
+ *   1. Explicit env vars (HICORTEX_LLM_BASE_URL + HICORTEX_LLM_API_KEY + HICORTEX_LLM_MODEL)
+ *   2. ANTHROPIC_API_KEY → Haiku (cheap, CC users always have this)
+ *   3. OPENAI_API_KEY → gpt-4o-mini
+ *   4. GOOGLE_API_KEY → gemini-2.0-flash
+ *   5. Fallback: Ollama at http://localhost:11434
+ *
+ * Supports: OpenAI, Anthropic, Google, OpenRouter, Ollama, z.ai, and 15+ more
  */
 export interface LlmConfig {
     baseUrl: string;
@@ -26,6 +33,17 @@ export declare function resolveLlmConfig(pluginConfig?: {
     llmModel?: string;
     reflectModel?: string;
 }): LlmConfig;
+/**
+ * Resolve LLM configuration for Claude Code (no OC config file).
+ * Uses env vars only — CC users always have ANTHROPIC_API_KEY.
+ * Defaults to Haiku for distillation/scoring (~$0.50/mo).
+ */
+export declare function resolveLlmConfigForCC(overrides?: {
+    llmBaseUrl?: string;
+    llmApiKey?: string;
+    llmModel?: string;
+    reflectModel?: string;
+}): LlmConfig;
 export declare class RateLimitError extends Error {
     retryAfterMs: number;
     constructor(retryAfterMs: number);

package/dist/llm.js

@@ -3,17 +3,25 @@
  * Multi-provider LLM client for consolidation and distillation.
  * Ported from hicortex/consolidate/llm.py.
  *
- * Resolution order for LLM provider:
+ * Resolution for OC adapter (resolveLlmConfig):
  *   1. Plugin config (llmBaseUrl, llmApiKey, llmModel)
  *   2. ~/.openclaw/openclaw.json agents.defaults.model.primary
  *   3. Environment vars: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY
  *   4. Fallback: Ollama at http://localhost:11434
  *
- * Supports: OpenAI, Anthropic (via OpenAI compat), Google, OpenRouter, Ollama, z.ai
+ * Resolution for CC adapter (resolveLlmConfigForCC):
+ *   1. Explicit env vars (HICORTEX_LLM_BASE_URL + HICORTEX_LLM_API_KEY + HICORTEX_LLM_MODEL)
+ *   2. ANTHROPIC_API_KEY → Haiku (cheap, CC users always have this)
+ *   3. OPENAI_API_KEY → gpt-4o-mini
+ *   4. GOOGLE_API_KEY → gemini-2.0-flash
+ *   5. Fallback: Ollama at http://localhost:11434
+ *
+ * Supports: OpenAI, Anthropic, Google, OpenRouter, Ollama, z.ai, and 15+ more
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LlmClient = exports.RateLimitError = void 0;
 exports.resolveLlmConfig = resolveLlmConfig;
+exports.resolveLlmConfigForCC = resolveLlmConfigForCC;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
@@ -51,6 +59,78 @@ function resolveLlmConfig(pluginConfig) {
         provider: "ollama",
     };
 }
+/**
+ * Resolve LLM configuration for Claude Code (no OC config file).
+ * Uses env vars only — CC users always have ANTHROPIC_API_KEY.
+ * Defaults to Haiku for distillation/scoring (~$0.50/mo).
+ */
+function resolveLlmConfigForCC(overrides) {
+    // 1. Explicit overrides (from config file or CLI args)
+    if (overrides?.llmBaseUrl && overrides?.llmApiKey) {
+        const provider = detectProvider(overrides.llmBaseUrl);
+        return {
+            baseUrl: overrides.llmBaseUrl,
+            apiKey: overrides.llmApiKey,
+            model: overrides.llmModel ?? "claude-haiku-4-5-20251001",
+            reflectModel: overrides.reflectModel ?? overrides.llmModel ?? "claude-sonnet-4-5-20250514",
+            provider,
+        };
+    }
+    // 2. Hicortex-specific env vars
+    const hcBaseUrl = process.env.HICORTEX_LLM_BASE_URL;
+    const hcApiKey = process.env.HICORTEX_LLM_API_KEY;
+    const hcModel = process.env.HICORTEX_LLM_MODEL;
+    if (hcBaseUrl && hcApiKey) {
+        const provider = detectProvider(hcBaseUrl);
+        return {
+            baseUrl: hcBaseUrl,
+            apiKey: hcApiKey,
+            model: hcModel ?? "claude-haiku-4-5-20251001",
+            reflectModel: process.env.HICORTEX_REFLECT_MODEL ?? hcModel ?? "claude-sonnet-4-5-20250514",
+            provider,
+        };
+    }
+    // 3. Standard API key env vars (CC users almost always have ANTHROPIC_API_KEY)
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    if (anthropicKey) {
+        return {
+            baseUrl: process.env.ANTHROPIC_BASE_URL ?? "https://api.anthropic.com",
+            apiKey: anthropicKey,
+            model: "claude-haiku-4-5-20251001",
+            reflectModel: "claude-sonnet-4-5-20250514",
+            provider: "anthropic",
+        };
+    }
+    const openaiKey = process.env.OPENAI_API_KEY;
+    if (openaiKey) {
+        const baseUrl = process.env.OPENAI_BASE_URL ?? "https://api.openai.com";
+        return {
+            baseUrl,
+            apiKey: openaiKey,
+            model: "gpt-4o-mini",
+            reflectModel: "gpt-4o-mini",
+            provider: detectProvider(baseUrl),
+        };
+    }
+    const googleKey = process.env.GOOGLE_API_KEY;
+    if (googleKey) {
+        return {
+            baseUrl: "https://generativelanguage.googleapis.com/v1beta",
+            apiKey: googleKey,
+            model: "gemini-2.0-flash",
+            reflectModel: "gemini-2.0-flash",
+            provider: "google",
+        };
+    }
+    // 4. Ollama fallback
+    return {
+        baseUrl: "http://localhost:11434",
+        apiKey: "",
+        model: "qwen3.5:4b",
+        reflectModel: "qwen3.5:4b",
+        provider: "ollama",
+    };
+}
 function detectProvider(url) {
     const u = url.toLowerCase();
     if (u.includes("ollama") || u.includes(":11434"))

package/dist/mcp-server.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hicortex MCP HTTP/SSE Server.
+ *
+ * Persistent HTTP server that exposes Hicortex tools via MCP protocol.
+ * Shared across all CC sessions (and future Codex/Gemini adapters).
+ * One process, one DB connection, one embedder — no per-session overhead.
+ *
+ * Endpoints:
+ *   GET  /health     — health check
+ *   GET  /sse        — SSE stream for MCP clients
+ *   POST /messages   — message endpoint for MCP clients
+ */
+export declare function startServer(options?: {
+    port?: number;
+    host?: string;
+    consolidateHour?: number;
+    dbPath?: string;
+    licenseKey?: string;
+}): Promise<void>;