@nex-ai/nex 0.1.7

package/dist/lib/client.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Configuration resolution: CLI flags > env vars > config file.
+ * Base URL is hardcoded to production (NEX_DEV_URL escape hatch for local dev).
+ */
+export declare const CONFIG_PATH: string;
+export declare const BASE_URL: string;
+export declare const API_BASE: string;
+export declare const REGISTER_URL: string;
+export interface NexConfig {
+    api_key?: string;
+    workspace_id?: string;
+    workspace_slug?: string;
+    default_format?: string;
+    default_timeout?: number;
+    [key: string]: unknown;
+}
+export declare function loadConfig(): NexConfig;
+export declare function saveConfig(config: NexConfig): void;
+/**
+ * Resolve API key from: flag > env > config file.
+ */
+export declare function resolveApiKey(flagValue?: string): string | undefined;
+/**
+ * Resolve output format from: flag > config file > default.
+ */
+export declare function resolveFormat(flagValue?: string): string;
+/**
+ * Resolve timeout from: flag > config file > default.
+ */
+export declare function resolveTimeout(flagValue?: string): number;
+/**
+ * Persist registration data to config file.
+ */
+export declare function persistRegistration(data: Record<string, unknown>): void;

package/dist/lib/config.js

@@ -0,0 +1,59 @@
+/**
+ * Configuration resolution: CLI flags > env vars > config file.
+ * Base URL is hardcoded to production (NEX_DEV_URL escape hatch for local dev).
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+export const CONFIG_PATH = join(homedir(), ".nex", "config.json");
+export const BASE_URL = process.env.NEX_DEV_URL ?? "https://app.nex.ai";
+export const API_BASE = `${BASE_URL}/api/developers`;
+export const REGISTER_URL = `${BASE_URL}/api/v1/agents/register`;
+export function loadConfig() {
+    try {
+        const raw = readFileSync(CONFIG_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+/**
+ * Resolve API key from: flag > env > config file.
+ */
+export function resolveApiKey(flagValue) {
+    return flagValue || process.env.NEX_API_KEY || loadConfig().api_key || undefined;
+}
+/**
+ * Resolve output format from: flag > config file > default.
+ */
+export function resolveFormat(flagValue) {
+    return flagValue || loadConfig().default_format || "json";
+}
+/**
+ * Resolve timeout from: flag > config file > default.
+ */
+export function resolveTimeout(flagValue) {
+    if (flagValue)
+        return parseInt(flagValue, 10);
+    return loadConfig().default_timeout ?? 120_000;
+}
+/**
+ * Persist registration data to config file.
+ */
+export function persistRegistration(data) {
+    const existing = loadConfig();
+    if (typeof data.api_key === "string")
+        existing.api_key = data.api_key;
+    if (typeof data.workspace_id === "string" || typeof data.workspace_id === "number") {
+        existing.workspace_id = String(data.workspace_id);
+    }
+    if (typeof data.workspace_slug === "string")
+        existing.workspace_slug = data.workspace_slug;
+    saveConfig(existing);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,oBAAoB,CAAC;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,QAAQ,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,QAAQ,yBAAyB,CAAC;AAWjE,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAkB;IAC9C,OAAO,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC,OAAO,IAAI,SAAS,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAkB;IAC9C,OAAO,SAAS,IAAI,UAAU,EAAE,CAAC,cAAc,IAAI,MAAM,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAkB;IAC/C,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,UAAU,EAAE,CAAC,eAAe,IAAI,OAAO,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACtE,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnF,QAAQ,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;QAAE,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC3F,UAAU,CAAC,QAAQ,CAAC,CAAC;AACvB,CAAC"}

package/dist/lib/context-format.d.ts

@@ -0,0 +1,7 @@
+export interface NexRecallResult {
+    answer: string;
+    entityCount: number;
+    sessionId?: string;
+}
+export declare function formatNexContext(result: NexRecallResult): string;
+export declare function stripNexContext(text: string): string;

package/dist/lib/context-format.js

@@ -0,0 +1,21 @@
+const OPEN_TAG = "<nex-context>";
+const CLOSE_TAG = "</nex-context>";
+export function formatNexContext(result) {
+    const parts = [
+        OPEN_TAG,
+        "The following is relevant context from the user's knowledge base. Use it to inform your response, but do not mention this block directly.",
+    ];
+    if (result.entityCount > 0) {
+        parts.push(`[${result.entityCount} related entities found]`);
+    }
+    parts.push("");
+    parts.push(result.answer);
+    parts.push(CLOSE_TAG);
+    return parts.join("\n");
+}
+export function stripNexContext(text) {
+    let result = text.replace(/<nex-context>[\s\S]*?<\/nex-context>/g, "");
+    result = result.replace(/<nex-context>[\s\S]*/g, "");
+    return result.trim();
+}
+//# sourceMappingURL=context-format.js.map

package/dist/lib/context-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.js","sourceRoot":"","sources":["../../src/lib/context-format.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,eAAe,CAAC;AACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAQnC,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,MAAM,KAAK,GAAa;QACtB,QAAQ;QACR,2IAA2I;KAC5I,CAAC;IACF,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,0BAA0B,CAAC,CAAC;IAC/D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error types for Nex CLI.
+ * Exit codes: 0 = success, 1 = general error, 2 = auth error.
+ */
+export declare class AuthError extends Error {
+    exitCode: number;
+    constructor(message?: string);
+}
+export declare class RateLimitError extends Error {
+    exitCode: number;
+    retryAfterMs: number;
+    constructor(retryAfterMs?: number);
+}
+export declare class ServerError extends Error {
+    exitCode: number;
+    status: number;
+    constructor(status: number, body?: string);
+}

package/dist/lib/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Error types for Nex CLI.
+ * Exit codes: 0 = success, 1 = general error, 2 = auth error.
+ */
+export class AuthError extends Error {
+    exitCode = 2;
+    constructor(message = "No API key configured. Run 'nex register' or set NEX_API_KEY.") {
+        super(message);
+        this.name = "AuthError";
+    }
+}
+export class RateLimitError extends Error {
+    exitCode = 1;
+    retryAfterMs;
+    constructor(retryAfterMs = 60_000) {
+        super(`Rate limited — retry after ${Math.ceil(retryAfterMs / 1000)}s`);
+        this.name = "RateLimitError";
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class ServerError extends Error {
+    exitCode = 1;
+    status;
+    constructor(status, body) {
+        super(`Nex API error ${status}${body ? `: ${body}` : ""}`);
+        this.name = "ServerError";
+        this.status = status;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,QAAQ,GAAG,CAAC,CAAC;IAEpB,YAAY,OAAO,GAAG,+DAA+D;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAChC,QAAQ,GAAG,CAAC,CAAC;IACb,YAAY,CAAS;IAE5B,YAAY,YAAY,GAAG,MAAM;QAC/B,KAAK,CAAC,8BAA8B,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC7B,QAAQ,GAAG,CAAC,CAAC;IACb,MAAM,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAa;QACvC,KAAK,CAAC,iBAAiB,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/lib/file-scanner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File scanner — discovers text files, tracks changes via content hash,
+ * and ingests new/changed files into Nex via POST /v1/context/text.
+ *
+ * Manifest stored at ~/.nex/file-scan-manifest.json.
+ */
+export interface ManifestEntry {
+    hash: string;
+    size: number;
+    scanned_at: string;
+}
+export interface Manifest {
+    version: number;
+    files: Record<string, ManifestEntry>;
+}
+export interface ScanOptions {
+    extensions: string[];
+    maxFiles: number;
+    depth: number;
+    force: boolean;
+    dryRun: boolean;
+}
+export interface ScanResult {
+    scanned: number;
+    skipped: number;
+    errors: number;
+    files: Array<{
+        path: string;
+        status: "ingested" | "skipped" | "error";
+        reason?: string;
+    }>;
+}
+export declare const MANIFEST_PATH: string;
+export declare function loadScanConfig(overrides?: Partial<ScanOptions>): ScanOptions;
+export declare function isScanEnabled(): boolean;
+export declare function loadManifest(): Manifest;
+export declare function saveManifest(manifest: Manifest): void;
+export declare function scanFiles(dir: string, opts: ScanOptions, ingestFn: (content: string, context: string) => Promise<unknown>): Promise<ScanResult>;

package/dist/lib/file-scanner.js

@@ -0,0 +1,178 @@
+/**
+ * File scanner — discovers text files, tracks changes via content hash,
+ * and ingests new/changed files into Nex via POST /v1/context/text.
+ *
+ * Manifest stored at ~/.nex/file-scan-manifest.json.
+ */
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from "node:fs";
+import { join, extname, resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+// --- Constants ---
+export const MANIFEST_PATH = join(homedir(), ".nex", "file-scan-manifest.json");
+const DEFAULT_EXTENSIONS = [
+    // Documents
+    ".md", ".txt", ".rtf", ".html", ".htm",
+    // Data / config
+    ".csv", ".tsv", ".json", ".yaml", ".yml", ".toml", ".xml",
+    // Code / scripts
+    ".js", ".ts", ".jsx", ".tsx", ".py", ".rb", ".go", ".rs", ".java",
+    ".sh", ".bash", ".zsh", ".fish",
+    // Markup / notes
+    ".org", ".rst", ".adoc", ".tex", ".log",
+    // Config / CI
+    ".env", ".ini", ".cfg", ".conf", ".properties",
+];
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", "dist", "build", ".next", "__pycache__", ".venv",
+    ".cache", ".turbo", "coverage", ".nyc_output",
+]);
+// --- Config from env ---
+export function loadScanConfig(overrides) {
+    const envEnabled = process.env.NEX_SCAN_ENABLED;
+    if (envEnabled === "false" || envEnabled === "0") {
+        // Caller should check this separately; config still resolves
+    }
+    const envExts = process.env.NEX_SCAN_EXTENSIONS;
+    const extensions = overrides?.extensions
+        ?? (envExts ? envExts.split(",").map((e) => e.trim()) : DEFAULT_EXTENSIONS);
+    const envMaxFiles = process.env.NEX_SCAN_MAX_FILES;
+    const maxFiles = overrides?.maxFiles
+        ?? (envMaxFiles ? parseInt(envMaxFiles, 10) : 5);
+    const envDepth = process.env.NEX_SCAN_DEPTH;
+    const depth = overrides?.depth
+        ?? (envDepth ? parseInt(envDepth, 10) : 20);
+    return {
+        extensions,
+        maxFiles,
+        depth,
+        force: overrides?.force ?? false,
+        dryRun: overrides?.dryRun ?? false,
+    };
+}
+export function isScanEnabled() {
+    const v = process.env.NEX_SCAN_ENABLED;
+    return v !== "false" && v !== "0";
+}
+// --- Manifest ---
+export function loadManifest() {
+    try {
+        const raw = readFileSync(MANIFEST_PATH, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.version === 1 && typeof data.files === "object")
+            return data;
+    }
+    catch {
+        // missing or corrupt
+    }
+    return { version: 1, files: {} };
+}
+export function saveManifest(manifest) {
+    mkdirSync(dirname(MANIFEST_PATH), { recursive: true });
+    writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+function discoverFiles(dir, extensions, maxDepth, currentDepth = 0) {
+    if (currentDepth > maxDepth)
+        return [];
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith(".") && SKIP_DIRS.has(entry))
+            continue;
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const fullPath = join(dir, entry);
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            results.push(...discoverFiles(fullPath, extensions, maxDepth, currentDepth + 1));
+        }
+        else if (stat.isFile() && extensions.has(extname(entry).toLowerCase())) {
+            results.push({ path: fullPath, size: stat.size, mtime: stat.mtimeMs });
+        }
+    }
+    return results;
+}
+// --- Hashing ---
+function hashFile(filePath) {
+    const content = readFileSync(filePath);
+    return "sha256-" + createHash("sha256").update(content).digest("hex");
+}
+// --- Scanner ---
+export async function scanFiles(dir, opts, ingestFn) {
+    const absDir = resolve(dir);
+    const extSet = new Set(opts.extensions.map((e) => (e.startsWith(".") ? e : `.${e}`).toLowerCase()));
+    // Discover files
+    const discovered = discoverFiles(absDir, extSet, opts.depth);
+    // Sort by mtime descending (newest first), cap at maxFiles
+    discovered.sort((a, b) => b.mtime - a.mtime);
+    const candidates = discovered.slice(0, opts.maxFiles);
+    const manifest = opts.force ? { version: 1, files: {} } : loadManifest();
+    const result = { scanned: 0, skipped: 0, errors: 0, files: [] };
+    for (const file of candidates) {
+        const hash = hashFile(file.path);
+        const existing = manifest.files[file.path];
+        // Skip if hash matches (already ingested)
+        if (existing && existing.hash === hash && !opts.force) {
+            result.skipped++;
+            result.files.push({ path: file.path, status: "skipped", reason: "unchanged" });
+            continue;
+        }
+        if (opts.dryRun) {
+            result.scanned++;
+            result.files.push({
+                path: file.path,
+                status: "ingested",
+                reason: existing ? "changed" : "new",
+            });
+            continue;
+        }
+        // Read and ingest
+        try {
+            const content = readFileSync(file.path, "utf-8");
+            if (!content.trim()) {
+                result.skipped++;
+                result.files.push({ path: file.path, status: "skipped", reason: "empty" });
+                continue;
+            }
+            await ingestFn(content, `file-scan:${file.path}`);
+            // Update manifest
+            manifest.files[file.path] = {
+                hash,
+                size: file.size,
+                scanned_at: new Date().toISOString(),
+            };
+            result.scanned++;
+            result.files.push({
+                path: file.path,
+                status: "ingested",
+                reason: existing ? "changed" : "new",
+            });
+        }
+        catch (err) {
+            result.errors++;
+            result.files.push({
+                path: file.path,
+                status: "error",
+                reason: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Persist manifest (unless dry-run)
+    if (!opts.dryRun) {
+        saveManifest(manifest);
+    }
+    return result;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/lib/file-scanner.js.map

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

package/dist/lib/installers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Platform-specific installers for Nex MCP server and Claude Code plugin.
+ *
+ * - Generic MCP installer handles 9/12 platforms (same JSON mcpServers format)
+ * - Claude Code installer handles hooks + slash commands
+ * - Zed installer uses context_servers instead of mcpServers
+ * - Continue.dev writes YAML config
+ */
+import type { Platform } from "./platform-detect.js";
+export declare function installMcpServer(platform: Platform, apiKey: string): {
+    installed: boolean;
+    configPath: string;
+};
+export declare function installClaudeCodePlugin(pluginDir?: string): {
+    installed: boolean;
+    hooksAdded: string[];
+    commandsLinked: string[];
+};
+export declare function syncApiKeyToMcpConfig(apiKey: string): void;

package/dist/lib/installers.js

@@ -0,0 +1,205 @@
+/**
+ * Platform-specific installers for Nex MCP server and Claude Code plugin.
+ *
+ * - Generic MCP installer handles 9/12 platforms (same JSON mcpServers format)
+ * - Claude Code installer handles hooks + slash commands
+ * - Zed installer uses context_servers instead of mcpServers
+ * - Continue.dev writes YAML config
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, symlinkSync, readdirSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const MCP_SERVER_ENTRY = {
+    command: "npx",
+    args: ["-y", "@nex-crm/mcp-server"],
+    env: {},
+};
+// --- Generic MCP Installer ---
+function readJsonFile(path) {
+    try {
+        const raw = readFileSync(path, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function writeJsonFile(path, data) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+export function installMcpServer(platform, apiKey) {
+    const entry = {
+        ...MCP_SERVER_ENTRY,
+        env: { NEX_API_KEY: apiKey },
+    };
+    if (platform.configFormat === "zed") {
+        return installZedMcp(platform.configPath, entry);
+    }
+    if (platform.configFormat === "continue") {
+        return installContinueMcp(platform.configPath, apiKey);
+    }
+    // Standard JSON format (Cursor, Claude Desktop, VS Code, Windsurf, Cline, Kilo Code, OpenCode)
+    const config = readJsonFile(platform.configPath);
+    if (!config.mcpServers || typeof config.mcpServers !== "object") {
+        config.mcpServers = {};
+    }
+    config.mcpServers.nex = entry;
+    writeJsonFile(platform.configPath, config);
+    return { installed: true, configPath: platform.configPath };
+}
+function installZedMcp(configPath, entry) {
+    const config = readJsonFile(configPath);
+    if (!config.context_servers || typeof config.context_servers !== "object") {
+        config.context_servers = {};
+    }
+    config.context_servers.nex = {
+        command: { path: entry.command, args: entry.args, env: entry.env },
+    };
+    writeJsonFile(configPath, config);
+    return { installed: true, configPath };
+}
+function installContinueMcp(configPath, apiKey) {
+    // Continue.dev can also accept JSON in a separate mcpServers config
+    // Write a simple JSON file alongside the YAML
+    const mcpPath = configPath.replace("config.yaml", "mcp.json");
+    const config = readJsonFile(mcpPath);
+    if (!config.mcpServers || typeof config.mcpServers !== "object") {
+        config.mcpServers = {};
+    }
+    config.mcpServers.nex = {
+        ...MCP_SERVER_ENTRY,
+        env: { NEX_API_KEY: apiKey },
+    };
+    writeJsonFile(mcpPath, config);
+    return { installed: true, configPath: mcpPath };
+}
+export function installClaudeCodePlugin(pluginDir) {
+    const home = homedir();
+    const claudeDir = join(home, ".claude");
+    const settingsPath = join(claudeDir, "settings.json");
+    // Resolve plugin directory — find it relative to the CLI package
+    const resolvedPluginDir = pluginDir ?? findPluginDir();
+    if (!resolvedPluginDir) {
+        return { installed: false, hooksAdded: [], commandsLinked: [] };
+    }
+    // 1. Read existing settings.json
+    let settings = {};
+    try {
+        const raw = readFileSync(settingsPath, "utf-8");
+        settings = JSON.parse(raw);
+    }
+    catch {
+        // Start fresh
+    }
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    const hooksAdded = [];
+    const distDir = join(resolvedPluginDir, "dist");
+    // 2. Add hooks (idempotent — check if nex hooks already exist)
+    const hookDefs = [
+        {
+            event: "SessionStart",
+            script: join(distDir, "auto-session-start.js"),
+            timeout: 120000,
+            statusMessage: "Loading knowledge context...",
+        },
+        {
+            event: "UserPromptSubmit",
+            script: join(distDir, "auto-recall.js"),
+            timeout: 10000,
+            statusMessage: "Recalling relevant memories...",
+        },
+        {
+            event: "Stop",
+            script: join(distDir, "auto-capture.js"),
+            timeout: 10000,
+            async: true,
+        },
+    ];
+    for (const def of hookDefs) {
+        if (!settings.hooks[def.event]) {
+            settings.hooks[def.event] = [];
+        }
+        const groups = settings.hooks[def.event];
+        const alreadyInstalled = groups.some((g) => g.hooks.some((h) => h.command.includes("nex") || h.command.includes("auto-recall") || h.command.includes("auto-capture") || h.command.includes("auto-session-start")));
+        if (!alreadyInstalled) {
+            const hookEntry = {
+                type: "command",
+                command: `node ${def.script}`,
+                timeout: def.timeout,
+            };
+            if (def.statusMessage)
+                hookEntry.statusMessage = def.statusMessage;
+            if (def.async)
+                hookEntry.async = true;
+            groups.push({ matcher: "", hooks: [hookEntry] });
+            hooksAdded.push(def.event);
+        }
+    }
+    // 3. Write settings.json
+    mkdirSync(claudeDir, { recursive: true });
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    // 4. Symlink slash commands
+    const commandsLinked = [];
+    const commandsDir = join(claudeDir, "commands");
+    const sourceCommandsDir = join(resolvedPluginDir, "commands");
+    if (existsSync(sourceCommandsDir)) {
+        mkdirSync(commandsDir, { recursive: true });
+        try {
+            const entries = readdirSync(sourceCommandsDir);
+            for (const entry of entries) {
+                if (!entry.endsWith(".md"))
+                    continue;
+                const target = join(commandsDir, entry);
+                const source = join(sourceCommandsDir, entry);
+                if (!existsSync(target)) {
+                    try {
+                        symlinkSync(source, target, "file");
+                        commandsLinked.push(entry);
+                    }
+                    catch {
+                        // May fail if file already exists as regular file — skip
+                    }
+                }
+            }
+        }
+        catch {
+            // Commands dir read failed — non-critical
+        }
+    }
+    return { installed: true, hooksAdded, commandsLinked };
+}
+/**
+ * Find the claude-code-plugin directory relative to the CLI install.
+ * Looks for it as a sibling package in the monorepo.
+ */
+function findPluginDir() {
+    // Try common locations
+    const candidates = [
+        // Sibling in monorepo (development)
+        resolve(__dirname, "..", "..", "..", "claude-code-plugin"),
+        // npm global install (node_modules sibling)
+        resolve(__dirname, "..", "..", "..", "..", "@nex-crm", "claude-code-nex-plugin"),
+        // Relative to cli package
+        resolve(__dirname, "..", "..", "claude-code-plugin"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(join(candidate, "package.json"))) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+// --- Sync API key to ~/.nex-mcp.json ---
+export function syncApiKeyToMcpConfig(apiKey) {
+    const mcpConfigPath = join(homedir(), ".nex-mcp.json");
+    const config = readJsonFile(mcpConfigPath);
+    config.api_key = apiKey;
+    writeJsonFile(mcpConfigPath, config);
+}
+//# sourceMappingURL=installers.js.map