@runcore-sh/runcore 0.1.2

package/dist/cli/backup.js

@@ -0,0 +1,176 @@
+/**
+ * CLI commands for manual brain backup and restore operations.
+ * Usage: npx tsx src/cli/backup.ts <command> [options]
+ *
+ * Commands:
+ *   backup              Run a backup now
+ *   restore <id>        Restore from a specific backup
+ *   list                List available backups
+ *   verify <id>         Verify a backup's integrity
+ *   status              Show backup service status
+ */
+import { getInstanceName } from "../instance.js";
+import { runBackup, restoreBackup, verifyBackup, listBackups } from "../services/backup.js";
+import { loadSettings } from "../settings.js";
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command || command === "--help" || command === "-h") {
+        printUsage();
+        process.exit(0);
+    }
+    // Load settings to get backup config
+    const settings = await loadSettings();
+    const config = settings.backup;
+    switch (command) {
+        case "backup":
+            await handleBackup(config, args);
+            break;
+        case "restore":
+            await handleRestore(config, args);
+            break;
+        case "list":
+            await handleList(config, args);
+            break;
+        case "verify":
+            await handleVerify(config, args);
+            break;
+        case "status":
+            await handleStatus(config);
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printUsage();
+            process.exit(1);
+    }
+}
+function printUsage() {
+    console.log(`
+${getInstanceName()} Brain Backup CLI
+
+Usage: npx tsx src/cli/backup.ts <command> [options]
+
+Commands:
+  backup [--provider <local|gdrive>]   Run a backup now
+  restore <backup-id> [--provider <local|gdrive>]   Restore from a backup
+  list [--provider <local|gdrive>]     List available backups
+  verify <backup-id> [--provider <local|gdrive>]    Verify backup integrity
+  status                               Show backup configuration
+
+Options:
+  --provider  Storage provider to use (default: from settings)
+  --help      Show this help message
+  `.trim());
+}
+function parseProvider(args) {
+    const idx = args.indexOf("--provider");
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    const p = args[idx + 1];
+    if (p === "local" || p === "gdrive")
+        return [p];
+    console.error(`Invalid provider: ${p}. Must be "local" or "gdrive".`);
+    process.exit(1);
+}
+async function handleBackup(config, args) {
+    const providers = parseProvider(args) ?? config.providers;
+    console.log(`Starting backup to: ${providers.join(", ")}...`);
+    const result = await runBackup(providers);
+    if (result.ok) {
+        console.log(`Backup completed: ${result.message}`);
+        if (result.manifest) {
+            console.log(`  ID: ${result.manifest.id}`);
+            console.log(`  Files: ${result.manifest.files.length}`);
+            console.log(`  Size: ${formatBytes(result.manifest.totalBytes)}`);
+            console.log(`  Encrypted files: ${result.manifest.files.filter((f) => f.encrypted).length}`);
+        }
+    }
+    else {
+        console.error(`Backup failed: ${result.message}`);
+        process.exit(1);
+    }
+}
+async function handleRestore(config, args) {
+    const backupId = args[1];
+    if (!backupId || backupId.startsWith("--")) {
+        console.error("Error: backup ID required. Usage: restore <backup-id> [--provider <local|gdrive>]");
+        process.exit(1);
+    }
+    const providers = parseProvider(args) ?? config.providers;
+    const provider = providers[0];
+    console.log(`Restoring backup ${backupId} from ${provider}...`);
+    console.log("WARNING: This will overwrite current brain/ files.");
+    const result = await restoreBackup(provider, backupId);
+    if (result.ok) {
+        console.log(`Restore completed: ${result.message}`);
+        console.log("IMPORTANT: Enter your safe word to decrypt episodic memory files.");
+    }
+    else {
+        console.error(`Restore failed: ${result.message}`);
+        process.exit(1);
+    }
+}
+async function handleList(config, args) {
+    const providers = parseProvider(args);
+    const provider = providers?.[0];
+    console.log("Available backups:\n");
+    const backups = await listBackups(provider);
+    if (backups.length === 0) {
+        console.log("  No backups found.");
+        return;
+    }
+    for (const b of backups) {
+        const encrypted = b.files.filter((f) => f.encrypted).length;
+        console.log(`  ${b.id}`);
+        console.log(`    Time:      ${b.timestamp}`);
+        console.log(`    Provider:  ${b.provider}`);
+        console.log(`    Files:     ${b.files.length} (${encrypted} encrypted)`);
+        console.log(`    Size:      ${formatBytes(b.totalBytes)}`);
+        console.log();
+    }
+}
+async function handleVerify(config, args) {
+    const backupId = args[1];
+    if (!backupId || backupId.startsWith("--")) {
+        console.error("Error: backup ID required. Usage: verify <backup-id> [--provider <local|gdrive>]");
+        process.exit(1);
+    }
+    const providers = parseProvider(args) ?? config.providers;
+    const provider = providers[0];
+    console.log(`Verifying backup ${backupId} on ${provider}...`);
+    const result = await verifyBackup(provider, backupId);
+    if (result.ok) {
+        console.log(`Verification passed: ${result.message}`);
+    }
+    else {
+        console.error(`Verification failed: ${result.message}`);
+        if (result.mismatches.length > 0) {
+            console.error("Mismatches:");
+            for (const m of result.mismatches) {
+                console.error(`  - ${m}`);
+            }
+        }
+        process.exit(1);
+    }
+}
+async function handleStatus(config) {
+    console.log("Backup Configuration:");
+    console.log(`  Enabled:    ${config.enabled}`);
+    console.log(`  Schedule:   ${config.schedule}`);
+    console.log(`  Providers:  ${config.providers.join(", ")}`);
+    console.log(`  Local dir:  ${config.localBackupDir}`);
+    console.log(`  Max keep:   ${config.maxBackups}`);
+    console.log(`  Hour:       ${config.backupHour}:00`);
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+main().catch((err) => {
+    console.error("Fatal error:", err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=backup.js.map

package/dist/cli/backup.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Core CLI — boot a local-first AI agent from any directory.
+ *
+ * Usage:
+ *   core                           Init (if needed) + start
+ *   core [--port <n>] [--dir <d>]  Start with options
+ *   core status                    Check if running
+ *   core --help                    Show help
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/cli.js

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+/**
+ * Core CLI — boot a local-first AI agent from any directory.
+ *
+ * Usage:
+ *   core                           Init (if needed) + start
+ *   core [--port <n>] [--dir <d>]  Start with options
+ *   core status                    Check if running
+ *   core --help                    Show help
+ */
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { exec } from "node:child_process";
+import { createServer } from "node:net";
+const VERSION = "0.1.0";
+const HELP = `
+runcore v${VERSION} — local-first AI agent runtime
+https://runcore.sh
+
+Usage:
+  runcore                     Start your agent (auto-inits if needed)
+  runcore --port <n>          Start on a specific port (default: 3577)
+  runcore --dir <path>        Use a specific directory
+  runcore status              Check if running
+  runcore --version           Print version
+
+Environment:
+  CORE_PORT          Server port (same as --port)
+  CORE_HOME          Brain directory root (same as --dir)
+
+Examples:
+  npx runcore                     # That's it. One command.
+  npx runcore --port 4000
+  npx runcore --dir ~/my-agent
+`.trim();
+// ── Arg parsing (no deps) ──────────────────────────────────────────
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1)
+        return undefined;
+    return args[idx + 1];
+}
+function hasFlag(args, ...flags) {
+    return flags.some((f) => args.includes(f));
+}
+const args = process.argv.slice(2);
+const command = args[0];
+// ── Init (idempotent — safe to run every time) ─────────────────────
+async function ensureBrain(root) {
+    const brainDir = join(root, "brain");
+    // Check if brain already exists
+    try {
+        await access(brainDir);
+        return false; // already exists
+    }
+    catch {
+        // needs init
+    }
+    console.log("First run — setting up brain...");
+    const dirs = [
+        "brain/memory",
+        "brain/identity",
+        "brain/knowledge/notes",
+        "brain/knowledge/research",
+        "brain/knowledge/protocols",
+        "brain/content/templates",
+        "brain/content/drafts",
+        "brain/operations",
+        "brain/agents/logs",
+        "brain/agents/tasks",
+        "brain/agents/runtime",
+        "brain/calendar",
+        "brain/contacts",
+        "brain/files/storage",
+        "brain/metrics",
+        "brain/ops",
+        "brain/sessions",
+        "brain/training",
+        "brain/skills",
+        "brain/library",
+        "brain/scheduling",
+        "brain/vault",
+    ];
+    for (const dir of dirs) {
+        await mkdir(join(root, dir), { recursive: true });
+    }
+    const seeds = {
+        "brain/memory/README.md": "# Memory\n\nAppend-only JSONL files: experiences, decisions, failures, semantic, procedural.\nNever delete or rewrite — use `\"status\": \"archived\"` to deprecate.\n",
+        "brain/knowledge/README.md": "# Knowledge\n\nResearch, notes, protocols, bookmarks.\n",
+        "brain/operations/OPERATIONS.md": "# Operations\n\nGoals, todos, changelog, backlog, insights.\n",
+        "brain/content/CONTENT.md": "# Content\n\nDrafts and templates for content creation.\n",
+        "brain/identity/personality.md": "Be concise. Be helpful. Read the room.\n",
+    };
+    for (const [rel, content] of Object.entries(seeds)) {
+        const fullPath = join(root, rel);
+        try {
+            await access(fullPath);
+        }
+        catch {
+            await writeFile(fullPath, content, "utf-8");
+        }
+    }
+    const settingsPath = join(brainDir, "settings.json");
+    try {
+        await access(settingsPath);
+    }
+    catch {
+        await writeFile(settingsPath, JSON.stringify({
+            airplaneMode: false,
+            models: { chat: "auto", agent: "auto" },
+            encryptBrainFiles: false,
+            safeWordMode: "restart",
+        }, null, 2), "utf-8");
+    }
+    console.log("Brain ready.\n");
+    return true;
+}
+// ── Port detection ────────────────────────────────────────────────
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const srv = createServer();
+        srv.once("error", () => resolve(false));
+        srv.once("listening", () => { srv.close(); resolve(true); });
+        srv.listen(port, "0.0.0.0");
+    });
+}
+async function findPort(preferred) {
+    if (await isPortAvailable(preferred))
+        return preferred;
+    // Try a few nearby ports, then random
+    for (let p = preferred + 1; p <= preferred + 10; p++) {
+        if (await isPortAvailable(p))
+            return p;
+    }
+    // OS-assigned random port
+    return new Promise((resolve, reject) => {
+        const srv = createServer();
+        srv.listen(0, "0.0.0.0", () => {
+            const addr = srv.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            srv.close(() => resolve(port));
+        });
+        srv.once("error", reject);
+    });
+}
+// ── Start ──────────────────────────────────────────────────────────
+async function startServer() {
+    const preferredPort = parseInt(getFlag(args, "--port") ?? process.env.CORE_PORT ?? process.env.DASH_PORT ?? "3577", 10);
+    const dirArg = getFlag(args, "--dir") ?? process.env.CORE_HOME;
+    const port = await findPort(preferredPort);
+    if (port !== preferredPort) {
+        console.log(`  Port ${preferredPort} in use, using ${port}`);
+    }
+    process.env.DASH_PORT = String(port);
+    if (dirArg) {
+        process.chdir(resolve(dirArg));
+    }
+    const root = process.cwd();
+    // Auto-init if no brain exists
+    await ensureBrain(root);
+    // Suppress JSON log noise during startup — only show warnings/errors
+    if (!process.env.LOG_LEVEL)
+        process.env.LOG_LEVEL = "warn";
+    // Spinner while server boots
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    let i = 0;
+    const spinner = setInterval(() => {
+        process.stdout.write(`\r  ${frames[i++ % frames.length]} Starting Core...`);
+    }, 80);
+    const { start, getStartupToken } = await import("./server.js");
+    await start();
+    clearInterval(spinner);
+    process.stdout.write("\r" + " ".repeat(40) + "\r");
+    // Auto-open browser with startup token for zero-friction onboarding
+    const token = getStartupToken();
+    if (token) {
+        const url = `http://localhost:${port}?token=${token}`;
+        // Open browser FIRST, then print — so browser gets focus
+        const openCmd = process.platform === "win32" ? `start "" "${url}"`
+            : process.platform === "darwin" ? `open "${url}"`
+                : `xdg-open "${url}"`;
+        exec(openCmd, () => { });
+        console.log(`\n  Core is ready on port ${port}\n`);
+    }
+}
+// ── Status ─────────────────────────────────────────────────────────
+async function status() {
+    const port = getFlag(args, "--port") ?? process.env.CORE_PORT ?? process.env.DASH_PORT ?? "3577";
+    const url = `http://localhost:${port}/api/health`;
+    try {
+        const res = await fetch(url);
+        if (res.ok) {
+            const data = (await res.json());
+            console.log(`Core is running on port ${port}`);
+            console.log(`  Status: ${data.status ?? "ok"}`);
+            if (data.uptime)
+                console.log(`  Uptime: ${Math.floor(data.uptime)}s`);
+        }
+        else {
+            console.log(`Core responded with ${res.status} on port ${port}`);
+        }
+    }
+    catch {
+        console.log(`Core is not running on port ${port}`);
+        process.exit(1);
+    }
+}
+// ── Dispatch ────────────────────────────────────────────────────────
+async function main() {
+    if (hasFlag(args, "--version", "-v")) {
+        console.log(VERSION);
+        return;
+    }
+    if (hasFlag(args, "--help", "-h")) {
+        console.log(HELP);
+        return;
+    }
+    // `core status` is the only subcommand
+    if (command === "status") {
+        await status();
+        return;
+    }
+    // Everything else: just start (with auto-init)
+    // Handles: `core`, `core start`, `core --port 4000`, `core --dir ./foo`
+    await startServer();
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG;WACF,OAAO;;;;;;;;;;;;;;;;;;CAkBjB,CAAC,IAAI,EAAE,CAAC;AAET,sEAAsE;AAEtE,SAAS,OAAO,CAAC,IAAc,EAAE,IAAY;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,GAAG,KAAe;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,sEAAsE;AAEtE,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAErC,gCAAgC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC,CAAC,iBAAiB;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG;QACX,cAAc;QACd,gBAAgB;QAChB,uBAAuB;QACvB,0BAA0B;QAC1B,2BAA2B;QAC3B,yBAAyB;QACzB,sBAAsB;QACtB,kBAAkB;QAClB,mBAAmB;QACnB,oBAAoB;QACpB,sBAAsB;QACtB,gBAAgB;QAChB,gBAAgB;QAChB,qBAAqB;QACrB,eAAe;QACf,WAAW;QACX,gBAAgB;QAChB,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,kBAAkB;QAClB,aAAa;KACd,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAA2B;QACpC,wBAAwB,EACtB,wKAAwK;QAC1K,2BAA2B,EACzB,yDAAyD;QAC3D,gCAAgC,EAC9B,+DAA+D;QACjE,0BAA0B,EACxB,2DAA2D;QAC7D,+BAA+B,EAC7B,0CAA0C;KAC7C,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,SAAS,CACb,YAAY,EACZ,IAAI,CAAC,SAAS,CACZ;YACE,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;YACvC,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,SAAS;SACxB,EACD,IAAI,EACJ,CAAC,CACF,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AAErE,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,SAAiB;IACvC,IAAI,MAAM,eAAe,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,sCAAsC;IACtC,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,MAAM,eAAe,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,0BAA0B;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AAEtE,KAAK,UAAU,WAAW;IACxB,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACxH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAE/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,UAAU,aAAa,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAExB,qEAAqE;IACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IAE3D,6BAA6B;IAC7B,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC9E,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,KAAK,EAAE,CAAC;IAEd,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnD,oEAAoE;IACpE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,oBAAoB,IAAI,UAAU,KAAK,EAAE,CAAC;QAEtD,yDAAyD;QACzD,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,GAAG,GAAG;YAClD,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;gBACjD,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAExB,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,sEAAsE;AAEtE,KAAK,UAAU,MAAM;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;IACjG,MAAM,GAAG,GAAG,oBAAoB,IAAI,aAAa,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,aAAc,IAAI,CAAC,MAAiB,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAgB,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,MAAM,YAAY,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,+CAA+C;IAC/C,wEAAwE;IACxE,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Centralized configuration defaults for all Core subsystems.
+ * Import from here instead of hardcoding constants across modules.
+ */
+export declare const OLP_SCAN_INTERVAL_MS: number;
+export declare const OLP_FIRST_RUN_DELAY_MS: number;
+export declare const OLP_MAX_ENTRIES_PER_SCAN = 50;
+export declare const OLP_MAX_RESONANCES = 30;
+export declare const OLP_VECTOR_SIMILARITY_THRESHOLD = 0.55;
+export declare const OLP_KEYWORD_HIT_THRESHOLD = 2;
+export declare const OLP_ACTIVE_TO_DORMANT_MS: number;
+export declare const OLP_DORMANT_TO_EXPIRED_MS: number;
+export declare const OLP_RESONANCE_MAX_AGE_MS: number;
+export declare const OLP_STALE_DAYS = 5;
+export declare const OLP_MERGE_SIMILARITY_THRESHOLD = 0.8;
+export declare const OLP_MIN_CONFIDENCE_FOR_ARCHIVE = 0.3;
+export declare const OLP_MAX_MERGE_COMPARISONS = 50;
+export declare const METRICS_MAX_POINTS = 10000;
+export declare const METRICS_MAX_AGE_MS: number;
+export declare const IM_GC_INTERVAL_MS = 30000;
+export declare const IM_GC_TTL_MS: number;
+export declare const IM_HEALTH_CHECK_INTERVAL_MS = 30000;
+export declare const IM_UNHEALTHY_THRESHOLD = 3;
+export declare const IM_MAX_HISTORY_PER_INSTANCE = 50;
+export declare const IM_MAX_AUTO_RESTARTS = 2;
+export declare const IM_GC_BATCH_SIZE = 100;
+export declare const IM_GC_MIN_INTERVAL_MS = 5000;
+export declare const IM_GC_JITTER_MS = 10000;
+export declare const HEALTH_RETRY_PENALTY = 15;
+export declare const HEALTH_RESTART_PENALTY = 10;
+export declare const HEALTH_FAILURE_PENALTY = 20;
+export declare const HEALTH_STUCK_INIT_PENALTY = 25;
+export declare const HEALTH_TIMEOUT_PENALTY = 20;
+export declare const HEALTH_DECAY_HALF_LIFE_MS: number;
+export declare const ACTIVITY_MAX_IN_MEMORY = 500;
+export declare const ACTIVITY_MAX_AGE_MS: number;
+export declare const VECTOR_AVAILABILITY_CACHE_MS = 30000;
+export declare const VECTOR_CIRCUIT_BREAKER_FAILURES = 3;
+export declare const VECTOR_CIRCUIT_BREAKER_COOLDOWN_MS: number;
+export declare const RECOVERY_MAX_TIMEOUT_MS: number;
+export declare const INSIGHT_ANALYSIS_INTERVAL_MS: number;
+export declare const INSIGHT_FIRST_RUN_DELAY_MS: number;
+export declare const INSIGHT_MAX_INSIGHTS = 50;
+export declare const INSIGHT_ESCALATION_COOLDOWN_MS: number;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AACpD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,+BAA+B,OAAO,CAAC;AACpD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,wBAAwB,QAA0B,CAAC;AAChE,eAAO,MAAM,yBAAyB,QAA0B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAsB,CAAC;AAI5D,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,8BAA8B,MAAO,CAAC;AACnD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAI5C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAItD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,YAAY,QAAa,CAAC;AACvC,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,eAAe,QAAS,CAAC;AAItC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAIxD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAIvD,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,kCAAkC,QAAgB,CAAC;AAIhE,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAItD,eAAO,MAAM,4BAA4B,QAAiB,CAAC;AAC3D,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AACxD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,8BAA8B,QAAqB,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,54 @@
+/**
+ * Centralized configuration defaults for all Core subsystems.
+ * Import from here instead of hardcoding constants across modules.
+ */
+// ─── Open Loop Scanner ──────────────────────────────────────────────────────
+export const OLP_SCAN_INTERVAL_MS = 5 * 60 * 1000; // 5 min
+export const OLP_FIRST_RUN_DELAY_MS = 3 * 60 * 1000; // 3 min
+export const OLP_MAX_ENTRIES_PER_SCAN = 50;
+export const OLP_MAX_RESONANCES = 30;
+export const OLP_VECTOR_SIMILARITY_THRESHOLD = 0.55;
+export const OLP_KEYWORD_HIT_THRESHOLD = 2;
+export const OLP_ACTIVE_TO_DORMANT_MS = 2 * 24 * 60 * 60 * 1000; // 2 days
+export const OLP_DORMANT_TO_EXPIRED_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+export const OLP_RESONANCE_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24h
+// ─── Open Loop Lifecycle ─────────────────────────────────────────────────────
+export const OLP_STALE_DAYS = 5;
+export const OLP_MERGE_SIMILARITY_THRESHOLD = 0.80;
+export const OLP_MIN_CONFIDENCE_FOR_ARCHIVE = 0.3;
+export const OLP_MAX_MERGE_COMPARISONS = 50;
+// ─── Metrics Store ───────────────────────────────────────────────────────────
+export const METRICS_MAX_POINTS = 10_000;
+export const METRICS_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24h
+// ─── Instance Manager ────────────────────────────────────────────────────────
+export const IM_GC_INTERVAL_MS = 30_000;
+export const IM_GC_TTL_MS = 5 * 60_000;
+export const IM_HEALTH_CHECK_INTERVAL_MS = 30_000;
+export const IM_UNHEALTHY_THRESHOLD = 3;
+export const IM_MAX_HISTORY_PER_INSTANCE = 50;
+export const IM_MAX_AUTO_RESTARTS = 2;
+export const IM_GC_BATCH_SIZE = 100;
+export const IM_GC_MIN_INTERVAL_MS = 5_000;
+export const IM_GC_JITTER_MS = 10_000;
+// ─── Health Score Weights ────────────────────────────────────────────────────
+export const HEALTH_RETRY_PENALTY = 15;
+export const HEALTH_RESTART_PENALTY = 10;
+export const HEALTH_FAILURE_PENALTY = 20;
+export const HEALTH_STUCK_INIT_PENALTY = 25;
+export const HEALTH_TIMEOUT_PENALTY = 20;
+export const HEALTH_DECAY_HALF_LIFE_MS = 30 * 60 * 1000; // 30 min half-life for score decay
+// ─── Activity Log ────────────────────────────────────────────────────────────
+export const ACTIVITY_MAX_IN_MEMORY = 500;
+export const ACTIVITY_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+// ─── Vector Index ────────────────────────────────────────────────────────────
+export const VECTOR_AVAILABILITY_CACHE_MS = 30_000; // 30s
+export const VECTOR_CIRCUIT_BREAKER_FAILURES = 3;
+export const VECTOR_CIRCUIT_BREAKER_COOLDOWN_MS = 5 * 60 * 1000; // 5 min
+// ─── Recovery ────────────────────────────────────────────────────────────────
+export const RECOVERY_MAX_TIMEOUT_MS = 15 * 60 * 1000; // 15 min cap
+// ─── Trace Insights ──────────────────────────────────────────────────────────
+export const INSIGHT_ANALYSIS_INTERVAL_MS = 10 * 60 * 1000; // 10 min
+export const INSIGHT_FIRST_RUN_DELAY_MS = 2 * 60 * 1000; // 2 min
+export const INSIGHT_MAX_INSIGHTS = 50;
+export const INSIGHT_ESCALATION_COOLDOWN_MS = 6 * 60 * 60 * 1000; // 6h per pattern
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

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

package/dist/contacts/index.d.ts

@@ -0,0 +1,3 @@
+export type { EntityType, EdgeType, EntityChannel, Entity, Edge, EntityFilter, EdgeFilter, } from "./types.js";
+export { ContactStore, createContactStore, getContactStore, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/contacts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contacts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/contacts/index.js

@@ -0,0 +1,2 @@
+export { ContactStore, createContactStore, getContactStore, } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/contacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contacts/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/contacts/store.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Contacts store — append-only JSONL persistence for entities and edges.
+ * Follows src/queue/store.ts pattern.
+ * All data encrypted at rest via brain-io.
+ *
+ * Files: brain/contacts/entities.jsonl, brain/contacts/edges.jsonl
+ * Update strategy: append full updated record. On load, last occurrence per id wins.
+ */
+import type { Entity, Edge, EntityType, EdgeType, EntityFilter, EdgeFilter } from "./types.js";
+export declare class ContactStore {
+    private readonly entitiesPath;
+    private readonly edgesPath;
+    private entityCache;
+    private edgeCache;
+    private entityMtime;
+    private edgeMtime;
+    private lastStaleCheckMs;
+    constructor(brainDir: string);
+    private ensureFiles;
+    private checkStale;
+    private loadEntities;
+    private loadEdges;
+    private invalidateEntities;
+    private invalidateEdges;
+    listEntities(filter?: EntityFilter): Promise<Entity[]>;
+    getEntity(id: string): Promise<Entity | null>;
+    createEntity(opts: {
+        type: EntityType;
+        name: string;
+        aliases?: string[];
+        channels?: Entity["channels"];
+        meta?: Record<string, unknown>;
+        notes?: string;
+        tags?: string[];
+    }): Promise<Entity>;
+    updateEntity(id: string, changes: Partial<Pick<Entity, "name" | "aliases" | "channels" | "meta" | "notes" | "tags" | "status">>): Promise<Entity | null>;
+    listEdges(filter?: EdgeFilter): Promise<Edge[]>;
+    getEdge(id: string): Promise<Edge | null>;
+    createEdge(opts: {
+        from: string;
+        to: string;
+        type: EdgeType;
+        label?: string;
+        since?: string;
+        notes?: string;
+    }): Promise<Edge>;
+    updateEdge(id: string, changes: Partial<Pick<Edge, "type" | "label" | "since" | "notes" | "status">>): Promise<Edge | null>;
+    /** Get all edges where entity is from or to. */
+    getRelationships(entityId: string): Promise<Edge[]>;
+    /** BFS traversal from entity to N hops. Returns entities and edges in the subgraph. */
+    getGraph(entityId: string, depth?: number): Promise<{
+        entities: Entity[];
+        edges: Edge[];
+    }>;
+}
+export declare function createContactStore(brainDir: string): ContactStore;
+export declare function getContactStore(): ContactStore | null;
+//# sourceMappingURL=store.d.ts.map

package/dist/contacts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/contacts/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiB/F,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,QAAQ,EAAE,MAAM;YAOd,WAAW;YAKX,UAAU;YAqBV,YAAY;YA0BZ,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,eAAe;IAIjB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBtD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK7C,YAAY,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBb,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBxJ,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAmB/C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAKzC,UAAU,CAAC,IAAI,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBX,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAkBjI,gDAAgD;IAC1C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAIzD,uFAAuF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;CAiCpG;AAMD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAIjE;AAED,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}