@nex-ai/nex 0.1.17 → 0.1.19

package/dist/plugin/shared.js

@@ -0,0 +1,241 @@
+/**
+ * Shared hook logic — platform-agnostic recall, capture, and session-start.
+ *
+ * Extracted from auto-recall.ts, auto-capture.ts, auto-session-start.ts
+ * so adapters for Cursor, Windsurf, Cline, etc. can reuse the same logic
+ * without duplicating filter/client/format code.
+ */
+import { loadConfig, loadScanConfig, ConfigError, isHookEnabled } from "./config.js";
+import { NexClient } from "./nex-client.js";
+import { formatNexContext } from "./context-format.js";
+import { captureFilter } from "./capture-filter.js";
+import { SessionStore } from "./session-store.js";
+import { shouldRecall, recordRecall } from "./recall-filter.js";
+import { RateLimiter } from "./rate-limiter.js";
+import { scanAndIngest } from "./file-scanner.js";
+import { ingestContextFiles } from "./context-files.js";
+import { readManifest, writeManifest, isChanged, markIngested } from "./file-manifest.js";
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join, extname } from "node:path";
+const sessions = new SessionStore();
+// ── Recall ──────────────────────────────────────────────────────────────
+/**
+ * Run recall logic: filter prompt → query Nex /ask → return formatted context.
+ * Returns null if recall is skipped or fails.
+ */
+export async function doRecall(prompt, sessionKey) {
+    if (!isHookEnabled("recall"))
+        return null;
+    const trimmed = prompt?.trim();
+    if (!trimmed || trimmed.length < 5)
+        return null;
+    if (trimmed.startsWith("/"))
+        return null;
+    const isFirst = sessionKey ? !sessions.get(sessionKey) : true;
+    const decision = shouldRecall(trimmed, isFirst);
+    if (!decision.shouldRecall)
+        return null;
+    const cfg = loadConfig();
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    const nexSessionId = sessionKey ? sessions.get(sessionKey) : undefined;
+    const result = await client.ask(trimmed, nexSessionId, 10_000);
+    if (!result.answer)
+        return null;
+    if (result.session_id && sessionKey) {
+        sessions.set(sessionKey, result.session_id);
+    }
+    recordRecall(result.session_id);
+    const entityCount = result.entity_references?.length ?? 0;
+    const context = formatNexContext({
+        answer: result.answer,
+        entityCount,
+        sessionId: result.session_id,
+    });
+    return { context, nexSessionId: result.session_id };
+}
+// ── Capture ─────────────────────────────────────────────────────────────
+const INGEST_TIMEOUT_MS = 3_000;
+const MAX_PLAN_FILES = 2;
+/**
+ * Run capture logic: filter message → ingest to Nex + scan plan files.
+ */
+export async function doCapture(input) {
+    if (!isHookEnabled("capture"))
+        return;
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch {
+        return;
+    }
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    const rateLimiter = new RateLimiter();
+    // Conversation capture
+    const message = input.message?.trim();
+    if (message) {
+        const filterResult = captureFilter(message);
+        if (!filterResult.skipped) {
+            if (rateLimiter.canProceed()) {
+                try {
+                    await client.ingest(filterResult.text, "claude-code-conversation", INGEST_TIMEOUT_MS);
+                }
+                catch (err) {
+                    process.stderr.write(`[nex-capture] Ingest failed: ${err instanceof Error ? err.message : String(err)}\n`);
+                }
+            }
+        }
+    }
+    // Plan file ingestion
+    const plansDir = input.planDir ?? join(process.cwd(), ".claude", "plans");
+    try {
+        await ingestPlanFiles(client, rateLimiter, plansDir);
+    }
+    catch (err) {
+        process.stderr.write(`[nex-capture] Plan file scan error: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+async function ingestPlanFiles(client, rateLimiter, plansDir) {
+    const scanConfig = loadScanConfig();
+    if (!scanConfig.enabled)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(plansDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const manifest = readManifest();
+    let ingested = 0;
+    for (const entry of entries) {
+        if (ingested >= MAX_PLAN_FILES)
+            break;
+        if (!entry.isFile())
+            continue;
+        if (extname(entry.name).toLowerCase() !== ".md")
+            continue;
+        const fullPath = join(plansDir, entry.name);
+        try {
+            const stat = statSync(fullPath);
+            if (!isChanged(fullPath, stat, manifest))
+                continue;
+            if (!rateLimiter.canProceed())
+                break;
+            let content = readFileSync(fullPath, "utf-8");
+            if (content.length > 100_000) {
+                content = content.slice(0, 100_000) + "\n[...truncated]";
+            }
+            const context = `claude-code-plan:${entry.name}`;
+            await client.ingest(content, context, INGEST_TIMEOUT_MS);
+            markIngested(fullPath, stat, context, manifest);
+            ingested++;
+        }
+        catch {
+            // skip individual file errors
+        }
+    }
+    if (ingested > 0)
+        writeManifest(manifest);
+}
+// ── Session Start ───────────────────────────────────────────────────────
+const SESSION_START_QUERY = "Summarize the key active context, recent interactions, and important updates for this user.";
+/**
+ * Run session-start logic: scan files → query Nex baseline → return context.
+ * Returns null if disabled. Returns registrationPrompt if no API key.
+ */
+export async function doSessionStart(source, sessionKey) {
+    if (!isHookEnabled("session_start"))
+        return null;
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            // No API key — return registration instructions
+            return {
+                context: "",
+                registrationPrompt: buildRegistrationPrompt(),
+            };
+        }
+        return null;
+    }
+    const client = new NexClient(cfg.apiKey, cfg.baseUrl);
+    const contextParts = [];
+    // File scan on startup or clear
+    const shouldScan = source === "startup" || source === "clear";
+    if (shouldScan) {
+        const rateLimiter = new RateLimiter();
+        const cwd = process.cwd();
+        try {
+            const ctxResult = await ingestContextFiles(client, rateLimiter, cwd);
+            if (ctxResult.ingested > 0) {
+                contextParts.push(`[Context files: ${ctxResult.ingested} ingested (${ctxResult.files.join(", ")})]`);
+            }
+        }
+        catch {
+            // non-fatal
+        }
+        try {
+            const scanConfig = loadScanConfig();
+            if (scanConfig.enabled) {
+                const scanResult = await scanAndIngest(client, rateLimiter, cwd, scanConfig);
+                if (scanResult.ingested > 0) {
+                    contextParts.push(`[File scan: ${scanResult.ingested} file${scanResult.ingested === 1 ? "" : "s"} ingested, ${scanResult.scanned} scanned]`);
+                }
+            }
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    const result = await client.ask(SESSION_START_QUERY, undefined, 10_000);
+    if (!result.answer && contextParts.length === 0)
+        return null;
+    if (result.session_id && sessionKey) {
+        sessions.set(sessionKey, result.session_id);
+    }
+    recordRecall(result.session_id);
+    const entityCount = result.entity_references?.length ?? 0;
+    const context = formatNexContext({
+        answer: result.answer,
+        entityCount,
+        sessionId: result.session_id,
+    });
+    const fullContext = contextParts.length > 0
+        ? `${context}\n${contextParts.join("\n")}`
+        : context;
+    return { context: fullContext, nexSessionId: result.session_id };
+}
+function buildRegistrationPrompt() {
+    return [
+        "[Nex Memory Plugin] No API key configured. Registration is required to enable persistent memory.",
+        "",
+        "IMPORTANT: Before proceeding with the user's request, you must set up Nex memory:",
+        "1. Ask the user for their email address to register for a Nex account",
+        "2. Run: nex register --email <email>",
+        "3. Then run: nex setup",
+        "",
+        "Keep it brief — just ask for the email and register. No restart needed after registration.",
+    ].join("\n");
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+/** Read stdin as a string (shared across all hook scripts). */
+export async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+/** Wrap output in Claude Code hookSpecificOutput format. */
+export function claudeCodeOutput(hookEventName, additionalContext) {
+    return JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName,
+            additionalContext,
+        },
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/plugin/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/plugin/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkB1C,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;AAEpC,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,UAAmB;IAEnB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAEtD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAE/D,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEhC,IAAI,MAAM,CAAC,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW;QACX,SAAS,EAAE,MAAM,CAAC,UAAU;KAC7B,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,2EAA2E;AAE3E,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAmB;IACjD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO;IAEtC,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,UAAU,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEtC,uBAAuB;IACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;gBACxF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACrF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uCAAuC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAiB,EACjB,WAAwB,EACxB,QAAgB;IAEhB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO;IAEhC,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,IAAI,cAAc;YAAE,MAAM;QACtC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,SAAS;QAE1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC;gBAAE,SAAS;YAEnD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;gBAAE,MAAM;YAErC,IAAI,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;gBAC7B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAAC;YAC3D,CAAC;YAED,MAAM,OAAO,GAAG,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;YACzD,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAChD,QAAQ,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC;QAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,2EAA2E;AAE3E,MAAM,mBAAmB,GACvB,6FAA6F,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,UAAmB;IAEnB,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,UAAU,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,gDAAgD;YAChD,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,kBAAkB,EAAE,uBAAuB,EAAE;aAC9C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,gCAAgC;IAChC,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YACrE,IAAI,SAAS,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAC3B,YAAY,CAAC,IAAI,CACf,mBAAmB,SAAS,CAAC,QAAQ,cAAc,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAClF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;YACpC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;gBAC7E,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;oBAC5B,YAAY,CAAC,IAAI,CACf,eAAe,UAAU,CAAC,QAAQ,QAAQ,UAAU,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,cAAc,UAAU,CAAC,OAAO,WAAW,CAC1H,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAExE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,IAAI,MAAM,CAAC,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW;QACX,SAAS,EAAE,MAAM,CAAC,UAAU;KAC7B,CAAC,CAAC;IAEH,MAAM,WAAW,GACf,YAAY,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,GAAG,OAAO,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC1C,CAAC,CAAC,OAAO,CAAC;IAEd,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;QACL,kGAAkG;QAClG,EAAE;QACF,mFAAmF;QACnF,uEAAuE;QACvE,sCAAsC;QACtC,wBAAwB;QACxB,EAAE;QACF,4FAA4F;KAC7F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,2EAA2E;AAE3E,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,iBAAyB;IAEzB,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,kBAAkB,EAAE;YAClB,aAAa;YACb,iBAAiB;SAClB;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nex-ai/nex",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Nex CLI provides organizational context & memory to AI agents",
   "type": "module",
   "bin": {
@@ -9,6 +9,8 @@
   "files": [
     "dist",
     "plugin-commands",
+    "platform-rules",
+    "platform-plugins",
     "README.md"
   ],
   "scripts": {

package/platform-plugins/continue-provider.ts

@@ -0,0 +1,62 @@
+/**
+ * Nex context provider for Continue.dev
+ *
+ * Add this to your ~/.continue/config.ts to enable @nex context:
+ *
+ * import { nexProvider } from "./.plugins/nex-provider";
+ * export default { contextProviders: [nexProvider] };
+ *
+ * This file is copied to ~/.continue/.plugins/nex-provider.ts by `nex setup`.
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+function loadApiKey(): string | null {
+  try {
+    const raw = readFileSync(join(homedir(), ".nex-mcp.json"), "utf-8");
+    return JSON.parse(raw).api_key ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export const nexProvider = {
+  title: "nex",
+  displayTitle: "Nex Context",
+  description: "Query organizational context, CRM, and memory from Nex",
+  type: "query" as const,
+
+  async getContextItems(query: string) {
+    const apiKey = loadApiKey();
+    if (!apiKey || !query.trim()) return [];
+
+    try {
+      const baseUrl = process.env.NEX_API_BASE_URL ?? "https://app.nex.ai";
+      const res = await fetch(`${baseUrl}/api/developers/v1/context/ask`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ query }),
+        signal: AbortSignal.timeout(10_000),
+      });
+
+      if (!res.ok) return [];
+      const data = (await res.json()) as { answer?: string };
+      if (!data.answer) return [];
+
+      return [
+        {
+          name: "Nex Context",
+          description: `Results for: ${query}`,
+          content: data.answer,
+        },
+      ];
+    } catch {
+      return [];
+    }
+  },
+};

package/platform-plugins/kilocode-modes.yaml

@@ -0,0 +1,17 @@
+customModes:
+  - slug: nex-crm
+    name: "Nex CRM"
+    roleDefinition: >
+      You are a CRM and organizational memory assistant powered by Nex.
+      You help users query their knowledge graph, CRM records, meetings,
+      communications, and organizational context. Use Nex MCP tools for
+      all queries about people, companies, deals, meetings, and emails.
+    customInstructions: >
+      Available Nex MCP tools: nex_ask (natural language query),
+      nex_remember (store information), nex_search (CRM lookup),
+      nex_list_integrations (check connections), nex_connect_integration (OAuth).
+      Always use nex_ask for knowledge queries. Use nex_search for name lookups.
+      Present results clearly with key entities highlighted.
+    groups:
+      - read
+      - mcp

package/platform-plugins/opencode-plugin.ts

@@ -0,0 +1,103 @@
+/**
+ * Nex plugin for OpenCode — organizational context & memory.
+ *
+ * This file is copied to .opencode/plugins/nex.ts by `nex setup`.
+ * OpenCode's bun runtime resolves imports at load time.
+ *
+ * Provides:
+ * - Session lifecycle hooks (context loading on session create)
+ * - Context preservation during compaction
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// Read API key from shared Nex config
+function loadApiKey(): string | null {
+  try {
+    const raw = readFileSync(join(homedir(), ".nex-mcp.json"), "utf-8");
+    const config = JSON.parse(raw);
+    return config.api_key ?? null;
+  } catch {
+    return null;
+  }
+}
+
+async function nexAsk(query: string, apiKey: string): Promise<string> {
+  const baseUrl = process.env.NEX_API_BASE_URL ?? "https://app.nex.ai";
+  const res = await fetch(`${baseUrl}/api/developers/v1/context/ask`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ query }),
+    signal: AbortSignal.timeout(10_000),
+  });
+  if (!res.ok) return "";
+  const data = await res.json() as { answer?: string };
+  return data.answer ?? "";
+}
+
+async function nexIngest(content: string, context: string, apiKey: string): Promise<void> {
+  const baseUrl = process.env.NEX_API_BASE_URL ?? "https://app.nex.ai";
+  await fetch(`${baseUrl}/api/developers/v1/context/text`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ content, context }),
+    signal: AbortSignal.timeout(5_000),
+  });
+}
+
+let cachedContext = "";
+
+export default {
+  name: "nex",
+
+  async "session.created"() {
+    const apiKey = loadApiKey();
+    if (!apiKey) return;
+
+    try {
+      const answer = await nexAsk(
+        "Summarize the key active context, recent interactions, and important updates for this user.",
+        apiKey,
+      );
+      if (answer) {
+        cachedContext = `<nex-context>\n${answer}\n</nex-context>`;
+      }
+    } catch {
+      // graceful degradation
+    }
+
+    return cachedContext ? { context: cachedContext } : undefined;
+  },
+
+  async "experimental.session.compacting"(_input: unknown, output: { context: string[] }) {
+    if (cachedContext) {
+      output.context.push(cachedContext);
+    }
+  },
+
+  async "session.completed"(_input: { messages?: Array<{ role: string; content: string }> }) {
+    const apiKey = loadApiKey();
+    if (!apiKey) return;
+
+    // Capture last assistant message
+    const messages = (_input as any)?.messages;
+    if (!Array.isArray(messages)) return;
+
+    const lastAssistant = [...messages].reverse().find((m) => m.role === "assistant");
+    if (!lastAssistant?.content || lastAssistant.content.length < 20) return;
+
+    try {
+      await nexIngest(lastAssistant.content.slice(0, 50_000), "opencode-conversation", apiKey);
+    } catch {
+      // graceful degradation
+    }
+  },
+};

package/platform-plugins/vscode-agent.md

@@ -0,0 +1,34 @@
+---
+name: nex
+description: "Query organizational context, CRM, meetings, and memory via Nex"
+tools:
+  - nex
+---
+
+You are the Nex agent. You help users query their organizational knowledge, CRM records, meetings, and communications.
+
+## Available MCP Tools
+
+- **nex_ask** — Query the knowledge graph with natural language (people, companies, deals, meetings, emails)
+- **nex_remember** — Store information for future recall across all connected platforms
+- **nex_search** — Search CRM records by name (people, companies, deals)
+- **nex_list_integrations** — Check connected data sources (Gmail, Slack, Salesforce, etc.)
+- **nex_connect_integration** — Connect a new data source via OAuth
+
+## When to Use
+
+Use Nex tools when the user asks about:
+- People, companies, organizations, or contacts
+- Deals, opportunities, or sales pipeline
+- Meetings, calendar events, or scheduling
+- Emails, messages, or communications
+- Organizational context, history, or relationships
+- Storing notes or information for later
+
+## Guidelines
+
+- Always use `nex_ask` for natural language queries about organizational knowledge
+- Use `nex_search` when looking up specific CRM records by name
+- Use `nex_remember` to store meeting notes, decisions, or important context
+- Present results clearly with key entities highlighted
+- If no results are found, suggest the user connect relevant data sources

package/platform-plugins/windsurf-workflows/nex-ask.md

@@ -0,0 +1,10 @@
+---
+name: nex-ask
+description: Ask Nex a question about organizational context, people, companies, deals, or meetings
+---
+
+Use the Nex MCP tool `nex_ask` to answer the user's question about organizational context.
+
+If the user provides a query, pass it directly. If not, ask what they'd like to know about their organizational context, CRM records, meetings, or communications.
+
+Always present the response clearly, highlighting key entities (people, companies, deals) and any relevant dates or action items.

package/platform-plugins/windsurf-workflows/nex-remember.md

@@ -0,0 +1,10 @@
+---
+name: nex-remember
+description: Store information in Nex knowledge base for future recall
+---
+
+Use the Nex MCP tool `nex_remember` to store the provided information in the user's knowledge base.
+
+If the user provides content, ingest it directly. If not, ask what they'd like to remember.
+
+Confirm what was stored and mention that it will be available for future recall across all connected platforms.

package/platform-plugins/windsurf-workflows/nex-search.md

@@ -0,0 +1,10 @@
+---
+name: nex-search
+description: Search for CRM records (people, companies, deals) by name
+---
+
+Use the Nex MCP tool `nex_search` to search for CRM records matching the user's query.
+
+If the user provides a search term, use it directly. If not, ask what they're looking for.
+
+Present results in a structured format showing name, type, and key details for each match.

package/platform-rules/aider-conventions.md

@@ -0,0 +1,38 @@
+# --- Nex Context & Memory ---
+
+# Nex — Organizational Context & Memory
+
+Nex provides your AI agent with real-time organizational knowledge — contacts, deals, meetings, emails, notes, and more — via MCP tools.
+
+## MCP Tools Available
+
+### `nex_ask` — AI-powered context query (recommended)
+Use for natural language questions about organizational context.
+Examples: "what's the latest on the Acme deal?", "when did I last talk to Sarah?"
+
+### `nex_remember` — Store information
+Save notes, observations, meeting summaries, or any text to the knowledge base.
+Examples: "remember that John prefers email over Slack", store meeting notes
+
+### `nex_search` — Fuzzy record lookup
+Search CRM records (people, companies, deals) by name or keyword.
+Use when looking up a specific named entity rather than asking a question.
+
+### `nex_list_integrations` — Check connected data sources
+Shows which integrations (Gmail, Slack, Calendar, CRM) are connected and active.
+
+### `nex_connect_integration` — Connect a data source
+Initiate OAuth connection for Gmail, Google Calendar, Outlook, Slack, Salesforce, HubSpot, or Attio.
+
+## When to Use Nex
+
+When the user asks about:
+- **People or companies** — contacts, relationships, org charts
+- **Deals or opportunities** — status, history, next steps
+- **Meetings or calls** — past conversations, upcoming schedules
+- **Emails or messages** — communication history
+- **Organizational context** — company knowledge, team notes, decisions
+
+Always try `nex_ask` first for general queries. Use `nex_search` when you need to find a specific record by name.
+
+# --- End Nex ---

package/platform-rules/cline-rules.md

@@ -0,0 +1,34 @@
+# Nex — Organizational Context & Memory
+
+Nex provides your AI agent with real-time organizational knowledge — contacts, deals, meetings, emails, notes, and more — via MCP tools.
+
+## MCP Tools Available
+
+### `nex_ask` — AI-powered context query (recommended)
+Use for natural language questions about organizational context.
+Examples: "what's the latest on the Acme deal?", "when did I last talk to Sarah?"
+
+### `nex_remember` — Store information
+Save notes, observations, meeting summaries, or any text to the knowledge base.
+Examples: "remember that John prefers email over Slack", store meeting notes
+
+### `nex_search` — Fuzzy record lookup
+Search CRM records (people, companies, deals) by name or keyword.
+Use when looking up a specific named entity rather than asking a question.
+
+### `nex_list_integrations` — Check connected data sources
+Shows which integrations (Gmail, Slack, Calendar, CRM) are connected and active.
+
+### `nex_connect_integration` — Connect a data source
+Initiate OAuth connection for Gmail, Google Calendar, Outlook, Slack, Salesforce, HubSpot, or Attio.
+
+## When to Use Nex
+
+When the user asks about:
+- **People or companies** — contacts, relationships, org charts
+- **Deals or opportunities** — status, history, next steps
+- **Meetings or calls** — past conversations, upcoming schedules
+- **Emails or messages** — communication history
+- **Organizational context** — company knowledge, team notes, decisions
+
+Always try `nex_ask` first for general queries. Use `nex_search` when you need to find a specific record by name.

package/platform-rules/continue-rules.md

@@ -0,0 +1,34 @@
+# Nex — Organizational Context & Memory
+
+Nex provides your AI agent with real-time organizational knowledge — contacts, deals, meetings, emails, notes, and more — via MCP tools.
+
+## MCP Tools Available
+
+### `nex_ask` — AI-powered context query (recommended)
+Use for natural language questions about organizational context.
+Examples: "what's the latest on the Acme deal?", "when did I last talk to Sarah?"
+
+### `nex_remember` — Store information
+Save notes, observations, meeting summaries, or any text to the knowledge base.
+Examples: "remember that John prefers email over Slack", store meeting notes
+
+### `nex_search` — Fuzzy record lookup
+Search CRM records (people, companies, deals) by name or keyword.
+Use when looking up a specific named entity rather than asking a question.
+
+### `nex_list_integrations` — Check connected data sources
+Shows which integrations (Gmail, Slack, Calendar, CRM) are connected and active.
+
+### `nex_connect_integration` — Connect a data source
+Initiate OAuth connection for Gmail, Google Calendar, Outlook, Slack, Salesforce, HubSpot, or Attio.
+
+## When to Use Nex
+
+When the user asks about:
+- **People or companies** — contacts, relationships, org charts
+- **Deals or opportunities** — status, history, next steps
+- **Meetings or calls** — past conversations, upcoming schedules
+- **Emails or messages** — communication history
+- **Organizational context** — company knowledge, team notes, decisions
+
+Always try `nex_ask` first for general queries. Use `nex_search` when you need to find a specific record by name.

package/platform-rules/cursor-rules.md

@@ -0,0 +1,34 @@
+# Nex — Organizational Context & Memory
+
+Nex provides your AI agent with real-time organizational knowledge — contacts, deals, meetings, emails, notes, and more — via MCP tools.
+
+## MCP Tools Available
+
+### `nex_ask` — AI-powered context query (recommended)
+Use for natural language questions about organizational context.
+Examples: "what's the latest on the Acme deal?", "when did I last talk to Sarah?"
+
+### `nex_remember` — Store information
+Save notes, observations, meeting summaries, or any text to the knowledge base.
+Examples: "remember that John prefers email over Slack", store meeting notes
+
+### `nex_search` — Fuzzy record lookup
+Search CRM records (people, companies, deals) by name or keyword.
+Use when looking up a specific named entity rather than asking a question.
+
+### `nex_list_integrations` — Check connected data sources
+Shows which integrations (Gmail, Slack, Calendar, CRM) are connected and active.
+
+### `nex_connect_integration` — Connect a data source
+Initiate OAuth connection for Gmail, Google Calendar, Outlook, Slack, Salesforce, HubSpot, or Attio.
+
+## When to Use Nex
+
+When the user asks about:
+- **People or companies** — contacts, relationships, org charts
+- **Deals or opportunities** — status, history, next steps
+- **Meetings or calls** — past conversations, upcoming schedules
+- **Emails or messages** — communication history
+- **Organizational context** — company knowledge, team notes, decisions
+
+Always try `nex_ask` first for general queries. Use `nex_search` when you need to find a specific record by name.